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How to Use This Manual 

The RT-11 software kit contains four generic operating systems that are 
designed to meet the needs of most RT-11 users. However, you need not be 
limited to the use of any one of these systems if they do not meet your 
needs. This manual provides you with the information you need to generate 
a system tailored to your specific needs. Chapter 1 describes the system 
generation procedure that you must follow and specific questions you must 
answer to generate your particular system. Chapter 2 tells you how to run 
the SYSGEN program to build the resulting system. Chapter 3 describes 
system generation on a dual-diskette system. However, DIGITAL does not 
recommend a system generation of this kind. 

Additional information available in the appendixes includes: system gener- 
ation answers that duplicate the standard, distributed monitors, system 
generation answers that create an example multiterminal system, RT-11 
conditionals, and customizations required for specially generated monitors. 

Before you begin, you should read the Guide to RT-11 Documentation, 
which describes the other software documents associated with the RT-11 
operating system. Familiarity with the RT-11 system, as described in the 
RT-11 System User's Guide, RT-11 System Utilities Manual, and Chapter 
1 of the RT-11 Installation Guide, is particularly helpful when you perform 
the procedures in this manual. 

If you are a FORTRAN IV, BASIC-11, CTS-300, or other layered product 
user, you build your FORTRAN IV, BASIC-11, FMS-11, CTS-300, or other 
system after building the RT-11 system. A layered product is software that 
is sold separately but requires the RT-11 operating system environment to 
run. See the appropriate installation manual for instructions on installing 
such products. 
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Documentation Conventions 

You should become familiar with certain symbolic conventions used in this 
manual. 

1. Examples consist of actual computer output whenever possible. In these 
examples, user input appears in red where it must be differentiated 
from computer output. 

2. Unless the manual indicates otherwise, all commands or command 
strings end with a carriage return. The symbol (ret) represents a car- 
riage return, © a line feed, HE) a space, ID an ESCAPE or ALTMODE, 
and @f a tab. 

3. To produce certain characters in system commands, you must type a 
combination of keys concurrently. For example, while holding down the 
CTRL key, type C to produce the CTRL/C character. Key combinations 
such as this are documented as (ctrl/c ) , (ctrl/o) , and so forth. 

4. In descriptions of command syntax, capital letters represent the com- 
mand name, which you must type. Lowercase letters represent a varia- 
ble for which you must supply a value. 

5. In examples, you must distinguish between the capital letter O and the 
number 0. Examples in this manual represent these characters as fol- 
lows: 

Letter O: 

Number 0: 

6. The sample terminal dialog in this manual contains version numbers 
where they would normally appear. The version numbers include xx in 
those fields that can vary from installation to installation. The exact 
contents of these fields are not of interest in the examples in this man- 
ual, as long as appropriate digits appear in the indicated area. The 
same is true for the FREE BLOCKS messages included in device direc- 
tories. 

If you submit a software performance report (SPR) to DIGITAL, you 
must include the complete version number. 

7. A decimal point (.) follows a number to indicate that it is a decimal 
number. A number without a decimal point is an octal number. For 
example, 128. is 128 (decimal) and 126 is 126 (octal). 



Vlll 



Chapter 1 

Preparing for System Generation 



You can build a unique RT-11 monitor through the system generation 
process; however, the procedure requires some preparation. Because the 
procedure lets you set the parameters for the system you want, you should 
be knowledgeable about the process and also prepared with the information 
and selections you will be called on to provide. 

System generation can be either an interactive or an automated procedure. 
You must run the program SYSGEN.COM through the IND processor and 
supply answers to the questions it asks. Answers can be supplied interac- 
tively through the console or automatically through an answer file. To 
complete the process, you will have to assemble and link one or more moni- 
tors and device handlers that will then reflect the parameters you set. 

The system generation process requires a significant amount of mass stor- 
age space and execution time. DIGITAL has distributed four standard mon- 
itors in the distribution kit and recommends that you undertake the system 
generation process only if none of these standard monitors fully meets your 
needs. 

Before beginning the system generation process, you should: 

1. Successfully install and test your working system. 

2. Determine whether the features you need are available only through 
system generation. (Read Chapter 1 of the RT-11 Installation Guide to 
assess whether or not you need to perform a system generation.) 

3. Become familiar with the RT-11 documentation, giving special atten- 
tion to the RT-11 System User's Guide and RT-11 System Utilities 
Manual, and to Chapter 1 of the RT-11 Installation Guide. 

4. Become comfortable with the keyboard monitor commands and RT-11 
operating characteristics. 

5. Read the installation guide for any layered products you have. (Some of 
these products require specific answers to SYSGEN questions.) 
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You should not attempt to perform the system generation process unless 
your hardware configuration meets certain requirements. 

DIGITAL supports automatic system generation (under license) only on a 
system with at least 16K words of memory and 2000 contiguous free blocks 
of disk storage. The minimum configuration that DIGITAL recommends for 
system generation is a system with at least two disk drives and 24K words 
of memory. 

DIGITAL also supports system generation on RX01 and RX02 diskette sys- 
tems (with at least 28K words of memory), provided you use the manual 
procedure described in Chapter 3. However, DIGITAL does not recommend 
this very lengthy method. 

To prepare for system generation, you should: 

1. Study the system generation process (Section 1-1). 

2. Gather the information or make decisions described in Section 1.2. 

3. Study the SYSGEN dialog (Section 1-3). 

You can use the worksheet at the end of this chapter (Figure 1-6) to record 
information, decisions, and choices. 

1.1 System Generation Process 

Once you have gathered some information about your configuration, you 
can run SYSGEN and answer the system generation questions to set the 
parameters for your special system. The command to run the system gener- 
ation process is: 

.RUN IND.SAV SYSGEN.COM 

IND.SAV is an indirect control file processor that uses the input file SYS- 
GEN.COM to drive the system generation process. (Both file type specifica- 
tions, .SAV and .COM, may be omitted.) However, if the command SET 
KMON IND was previously issued, you can use the indirect command 

©SYSGEN. 

The questions that you are asked are in the form of a dialog. SYS- 
GEN.COM contains the dialog and the monitor conditionals. It contains 
IND directives to display explanatory text, query for options, open input 
and output files, test the validity of responses, test and modify conditions, 
and set values for variables. Executing SYSGEN.COM produces the follow- 
ing default output files: 

• SYSGEN.CND 

• SYSGEN.TBL 

• SYSGEN.BLD 
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• SYSGEN.MON 

• SYSGEN.DEV 

• SYSGEN.ANS 

SYSGEN allows you to choose your own names for them. Your responses to 
the dialog establish the conditionals that SYSGEN writes to the condi- 
tional file SYSGEN.CND. SYSGEN uses some of the conditionals that it 
generates to create SYSGEN.TBL, another conditional file that sets up 
device table entries for each device you specify and defines device handlers. 
SYSGEN.TBL is included in the assembly and link procedures for all gen- 
erated monitors. (For a list of RT-11 conditionals, refer to Appendix C.) 

SYSGEN also creates three indirect command files: SYSGEN.BLD, SYS- 
GEN.MON, and SYSGEN.DEV. These files contain all the command 
strings that perform the assemblies and links that build the system you 
specify when you answer the dialog questions. SYSGEN.MON builds the 
monitor or monitors you define; SYSGEN.DEV builds the device handlers 
you define. SYSGEN.BLD executes SYSGEN.MON and SYSGEN.DEV. 

SYSGEN.COM optionally creates a user-defined answer file, named SYS- 
GEN.ANS by default. This file reflects all responses made during the sys- 
tem generation session, and can be used as input during a later system 
generation session to generate a new monitor without running the entire 
system generation dialog. When an answer file is used, SYSGEN does not 
ask the dialog questions; rather, it gets all the necessary information for 
the attributes of the system to be generated from the answer file. After 
executing the file, SYSGEN allows you to alter the output file to reflect any 
changes you wish to make, for example, to add monitor options, to support 
additional peripheral devices, or to change device addresses. 

Ultimately, you must assemble and link the SYSGEN.CND, SYS- 
GEN.TBL, and (optionally) TRMTBL.MAC conditional files with certain 
system source files, depending on options you choose during system genera- 
tion. For example, you would need RMONSJ.MAC, the SJ resident monitor 
source file, if your desired system included the SJ monitor. The conditional 
file TRMTBL.MAC, which is distributed with your system software, is re- 
quired only if you are building a multiterminal system. The source file 
EDTGBL.MAC is always required, because it contains system-wide defini- 
tions. 

Once you have answered the SYSGEN questions, copy the system source 
files you need (SYSGEN.CND and SYSGEN.TBL) to the volume that the 
command files use as the source input device. Then assemble and link the 
sources with the conditional files (using SYSGEN.BLD alone or, if you 
wish, SYSGEN.MON and SYSGEN.DEV). You can enter the commands 
individually if you choose. 

Figure 1-1 shows the procedures involved in the system generation process; 
Figure 1-2 shows the files required for system generation. 
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Figure 1-1: System Generation Process 
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Figure 1-2: SYSGEN Input and Output Files 
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1.2 Gathering Information 



To answer SYSGEN dialog questions, you must be familiar with both the 
target system configuration (that is, the one you are generating) and your 
current configuration (that is, the one on which you will run SYSGEN and 
assemble and link the new monitor or monitors and handlers). You should 
also know which monitor services you want in the target system and which 
vector and control status register (CSR) addresses are involved. You will be 
unable to perform the system build process unless you know your current 
configuration and its capabilities, you have planned an optimal file ar- 
rangement for system build on your configuration, and you have answered 
the relevant SYSGEN dialog questions appropriately. In addition, you may 
have to edit the conditional files before you build the target system. To 
make sure that you have all the information you need, identify the follow- 
ing: 

1. Peripheral devices to be supported in the special system you are gener- 
ating (that is, the target system) 

2. Interrupt vector and CSR addresses for devices in the target system 

3. Monitor services you require for the target system 

4. Edits you may need to make to the conditional files 

5. Device assignments for the system build procedure 

The following sections describe how to identify these items. 

1.2.1 Peripheral Devices 

Identify all the peripheral devices that your target system configuration 
will include. List the device mnemonic for each device on the worksheet at 
the end of this chapter (for example, DY for an RX02 diskette). 

NOTE 

You may need to include some empty device slots to make 
sure that your system has enough device slots for your appli- 
cation's requirements. The number of logical device assign- 
ments you will be able to make in the working system is 
equal to the number of device slots available in the system. 

1.2.2 Interrupt Vectors and CSRs 

Identify the interrupt vector addresses and CSR addresses at which the 
field service technician installed each peripheral in your configuration. 
When installing the hardware, the field service technician is responsible 
for leaving a written record of this address information at your site, usually 
on a sticker attached to the processor. List each address on the worksheet 
(Figure 1-6). 
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Although most peripherals have standard interrupt vector and CSR ad- 
dresses, some have floating addresses. The presence or absence of such 
floating address devices affects the addresses at which the other floating 
address devices in the system are installed. (Floating address devices must 
be installed in a standard sequence.) Even devices with standard vectors 
may have been installed at nonstandard addresses. 

1.2.3 Monitor Services for Target Application 

DIGITAL has generated the standard monitors through the system genera- 
tion process; you will probably need to select support for features that 
standard monitors also support. In other words, many SYSGEN questions 
offer features you will recognize as standard features in the distributed 
monitors. Table 1-1 summarizes special features that are available only 
through the system generation process. 

Table 1-1: Features Available Only Through System Generation 
Process 



Feature 



Function 



Asynchronous 
terminal status 

BATCH 



Device I/O 

timeout 

Disable .FETCH 
request under 
XM 

Double- 
density 
only RX02 

DZ11 up to 
9600 baud 

Error logging 



Extra device 
slots 

High-speed 
ring buffer 



Provides a program with the updated status of terminals in 
multiterminal systems. MU BASIC-11 require this support. 

Allows RT-11 to operate unattended. All monitors except BL 
support BATCH. 

Permits device handlers to issue a mark-time programmed 
request. DECnet applications require this support. 

Disables the use of the .FETCH request under XM, requiring 
device handlers to be resident in memory. 

Permits you to use only double-density RX02 diskettes on the 
system. This feature makes the RX02 handler smaller. 

Permits you to initialize lines at specific baud rates up to 
9600. 

Keeps a statistical record of device, memory parity, and mem- 
ory cache errors. An error logging job is created when you 
select this support for FB; a handler is created for SJ. The EL 
job retrieves information that is later available to you in sum- 
mary report format. 

Permits you to add devices to the system after it is built. The 
number of logical assignments you can make is equal to the 
number of devices plus empty device slots in the system. 

Causes character processing and interpretation to be per- 
formed at fork level. This allows short bursts of characters 
transmitted at very high rates to be received. Use of this fea- 
ture is recommended with PDTs. 



(continued on next page) 



1-6 Preparing for System Generation 



Table 1-1: Features Available Only Through System Generation 
Process (Cont.) 



Feature 



Function 



Keyboard 

monitor 

command 

subsets 

Memory parity 



Month and year 
rollover 



Multiterminal 
support 

Multiterminal 
timeout 



Programmable 
clock as 
system clock 

Ring buffer 
size 



Second RX01, 
RX02, or TU58 
controller 

SJ message 
on system 
I/O errors 

SJ timer 



Allows you to choose one, two, or three subsets of the keyboard 
monitor commands instead of all the commands. 



Causes the system to print an error message when a memory 
parity error occurs if your configuration includes memory par- 
ity hardware. If you have this hardware but do not select this 
support, the system halts when memory errors occur. 

Adds support that automatically rolls over the date at the end 
of the month and the end of the year. Normally, you must 
reset the date and time. This support is useful for applications 
that run continuously and over a long period of time. 

Permits you to use two or more terminals with the SJ, FB, or 
XM monitor. MU BASIC-11 requires this support. 

Causes the monitor to reset at regular intervals any terminal 
that goes off line. This support minimizes the impact of static 
in multiterminal systems. MU BASIC-11 requires this sup- 
port. 

Allows you to substitute as the system clock the KW11-P pro- 
grammable clock for the usual line clock. However, the pro- 
grammable clock would not then be available for program use. 

Allows you to change the size of the input and output ring 
buffers. The input ring is a buffer in the monitor that holds 
characters you type at a terminal until a program requests 
them. The output ring is a buffer in the monitor that holds 
characters until the terminal can print them. The default in- 
put ring buffer size is 134 (decimal) characters, and the de- 
fault output ring buffer size is 40 (decimal) characters. 

Adds support for a second RX01, RX02, or TU58 RX02, or 
TU58 controller, allowing a total of four units in the configu- 
ration instead of the usual two. 

Causes the SJ monitor to issue an error message instead of 
simply halting. This feature helps to reduce confusion when 
an error occurs. The FB and XM monitors always issue error 
messages. 

Configures the SJ monitor to support mark-time and cancel 
mark-time programmed requests. Otherwise, only the FB and 
XM monitors support these requests, which provide timer ca- 
pabilities. 



(continued on next page) 
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Table 1-1: Features Available Only Through System Generation 
Process (Cont.) 



Feature Function 

.SPCPS Changes the flow of control of main-line code by saving the PC 

programmed and PS and changing the main-line PC to a new value. This 

request support can be generated for only the FB and XM monitors. 

.SPCPS is especially useful for controlling switching among 

users in multiuser applications. 

System jobs Assembles the FB monitor to support as many as eight simul- 

taneously active jobs instead of the usual two. Both the error 
logging subsystem and the device queue program (QUEUE) 
can run as system jobs. This feature is available in the distrib- 
uted XM monitor. 

User command Permits users to create their own commands, 

linkage 

Every SYSGEN dialog question is a SYSGEN option. Some options enable 
support for monitor services, while other options enable support for periph- 
eral devices and device interfaces. The options that enable monitor services 
are as follows: 

Asynchronous terminal status 

BATCH support 

Device timeout support 

Error logging support 

Error messages on system I/O errors 

.FETCH request 

Floating point support 

50 Hz clock rather than 60 Hz 

High-speed ring buffer 

Input ring buffer size 

Keyboard monitor command subsets 

Memory parity 

Month and year date rollover 

Multiterminal support 

Multiterminal timeout 

Output ring buffer size 

Power failure message 
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Programmable clock as system clock 

SJ timer support 

.SPCPS programmed request 

Start-up indirect command file 

System jobs 

User command linkage 

Section 1.3 describes each dialog question in detail. When you study the 
dialog, check off on the worksheet any options you want to select when you 
actually run SYSGEN. 

1.2.4 Edits to SYSGEN.CND File 

Before you assemble your monitor, it is possible to edit SYSGEN.CND, the 
conditional file that SYSGEN produces. SYSGEN.CND contains condition- 
als that, when assembled with system source files, enable options chosen 
during the SYSGEN session. Editing this file lets you, in effect, change 
responses to the dialog without rerunning SYSGEN. However, DIGITAL 
recommends that, under most circumstances, you rerun SYSGEN and 
change any necessary responses. Editing SYSGEN.CND requires great 
care. For the most part, only the most knowledgeable user should try to 
manipulate the conditional files. 

This rule has several exceptions, which call for minor edits in special situa- 
tions. If you find it necessary to edit a conditional file, list these edits on the 
worksheet (Figure 1-6). 

One such case where you may find it necessary to edit the SYSGEN.CND 
file is the inclusion of multiterminal support for the United Kingdom. 
United Kingdom applications require RT-11 to disconnect a remote line 
immediately when the line hangs up. Normally, RT-11 delays disconnect- 
ing remote lines when it loses the carrier. It waits for a specific period of 
time to avoid dropping lines due to noise. You can add a conditional to 
SYSGEN.CND that adds support for immediate disconnect of DL11-E in- 
terfaces with modem support. To include immediate disconnect support, 
insert the following line in the file SYSGEN.CND: 

U.K. = 1 

NOTE 

DIGITAL does not support the use of edited answer files. To 
make a change to an answer file, run SYSGEN, specifying 
input and output answer file names. The same file name may 
be used for both input and output answer files. After SYS- 
GEN reads in the answer file, it will ask if you want to make 
any changes. The changes you make will be reflected in the 
output answer file. 
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1.2.5 System Build Procedure 

The system build procedure requires that you assemble and link your gen- 
erated monitors and handlers but not the utility programs or other nonex- 
ecutive system components. The SYSGEN program produces indirect com- 
mand files that issue all the commands to perform these assemblies and 
links. However, if your only mass storage device is an RX01 or RX02 disk- 
ette, you may have insufficient free storage space to use indirect command 
files, so you will need to issue individual commands to perform the same 
system build procedures. (Refer to Chapter 3.) 

The following sections describe both system build procedures, so that you 
can plan the method you will use and answer the SYSGEN dialog questions 
relative to the indirect command files. 

NOTE 

Once you have created the conditional files SYSGEN.CND 
and SYSGEN.TBL, you can use them over and over without 
rerunning the SYSGEN program. To add source customiza- 
tions to your generated system, simply use the SLP utility to 
customize your system. Then, reassemble those files, and re- 
link the system. 

1.2.5.1 Automatic System Build — At the end of the system generation 
process, the SYSGEN dialog asks you to identify the devices that the indi- 
rect command files should use for input, binary output, and map output 
during the assembly and link processes. When you answer the dialog ques- 
tions and SYSGEN completes, SYSGEN has tailored the indirect command 
files, so that they make the logical assignments SRC:, BIN:, and MAP: 
according to your instructions. The command files then expect to find the 
correct files on each device. Therefore, before you answer these questions, 
you must know which files you want and how much free space you need for 
the build procedure. Then you must plan the organization of files so that 
you can choose the appropriate devices for SRC:, BIN:, and MAP:. Figures 
1-3 through 1-5 illustrate examples of such organization. 

NOTE 

If you answer NO to the SYSGEN question "Do you want to 
retain the system OBJs?", the indirect command files include 
deletion commands to remove the .OBJ files. 

In most cases, you can use the indirect command files to build your system, 
but you may want to make minor alterations to the command files them- 
selves. For example, you might need to change the devices on which indi- 
vidual source or binary files reside to optimize mass storage usage. 
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Study the following paragraphs, which categorize requirements by device. 
Then organize files on volumes according to the: 

• Hardware you have available 

• Free storage you have 

• Storage requirements for building each component 

If possible, you will want to use the largest and fastest storage devices 
included in your configuration. 

System Device 

When you perform the system build procedures, you must run RT-11 from 
a system device that contains at least the following: 

Monitor 

System device handler 

SWAP.SYS 

Handlers for SRC:, BIN:, and MAP: 

MACRO 

LINK 

PIP 

SYSMAC.SML 

During the build procedure, the default (DK) device needs as many as 128 
free blocks to accommodate the work file MACRO uses during system as- 
sembly. 

Source Input Device 

The source input device must contain the files SYSGEN.CND and SYS- 
GEN.TBL, which are the conditional files that result from a SYSGEN ses- 
sion, and TRMTBL.MAC, which is required only if you plan multiterminal 
support. In addition, the source device must include the system source files 
to build the system you are generating. 

The system source files are included in the distribution kit, but you proba- 
bly did not include them in your working system. You will need to copy the 
appropriate source files from your customized distribution backup vol- 
ume(s). Establish which source files you need by using Table 1-2, and write 
the file names on the worksheet. 
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Table 1-2: Source Files Required for System Build 



Source 




File 


To Build Support For 


BA.MAC 


BATCH 


BSTRAP.MAC 


All monitors 


CR.MAC 


Card reader 


CT.MAC 


TA11 cassette 


DD.MAC 


DECtape II cartridge 


DL.MAC 


RL01/02 disk 


DM.MAC 


RK06/07 disk 


DP.MAC 


RP11/RPR02/RP03 


DS.MAC 


RJS03/04 disk 


DT.MAC 


DECtape 


DU.MAC 


MSCP-class devices 


DX.MAC 


RX01 diskette 


DY.MAC 


RX02 diskette 


EDTGBL.MAC 


All monitors 


EL.MAC 


Error logging 


ELCOPY.MAC 


Error logging 


ELINIT.MAC 


Error logging 


ELTASK.MAC - 


Error logging 


ERRTXT.MAC 


Error logging 


FB.MAC 


FB monitor 


FSM.MAC 


File-structured magtape 


KMON.MAC 


All monitors 


KMOVLY.MAC 


All monitors 


LD.MAC 


Logical disk subsetting 


LP.MAC 


Line printer 


LS.MAC 


Serial line printer 


MTTEMT.MAC 


Multiterminals 


MTTINT.MAC 


Multiterminals 


NL.MAC 


Null handler 


PC. MAC 


High-speed paper tape 


PD.MAC 


PDT-11 series 


RF.MAC 


RF11 disk 


RK.MAC 


RK05 disk 


RMONFB.MAC 


FB or XM monitor 


RMONSJ.MAC 


SJ monitor 


SJ.MAC 


SJ monitor 


SYSGEN.CND* 


All monitors 


SYSGEN.TBL* 


All devices 


TJ.MAC 


TJU16 magtape 


TM.MAC 


TM11 magtape 


TRMTBL.MAC 


All monitors 


TS.MAC 


TS11 magtape 


TT.MAC 


SJ monitor 


USR.MAC 


All monitors 


VM.MAC 


Virtual memory "disk" 


XM.MAC 


XM monitor 


XMSUBS.MAC 


XM monitor 



Or specified file name. 
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Binary Output Device 

The binary output device receives the object files created by the assembly 
process. Identify all the components you must build, that is, all the moni- 
tors and device handlers for which your SYSGEN answers are intended. 
Then refer to Table 1-3 to establish how much free storage you will need on 
the binary output device to build each of these components. 

Table 1-3: Free Storage Required to Build Components 

Number of 
Component Blocks 

Monitor 300 

Device handler 11 

Set of monitor object modules retained 200 

Set of handler object modules retained 8 

When a device is initialized, some space is used for the boot and directory 
blocks. Table 1-4 shows the number of free blocks remaining on various 
devices, after being initialized. 

Table 1-4: Free Blocks on Devices After Initialization 



Device 


Device 

Name 


Size in 
Blocks 


RX01 diskette 


DX 


486 


RX02 diskette 


DY 


974 


RK05 disk 


RK 


4.8K 


RL01/02 disk 


DL 


10.2/20.4K 


RK06/07 disk 


DM 


27.1/53. 7K 


RX50 diskette 


DU 


786 


RD51 disk 


DU 


19.6K 


RC25 disk 


DU 


43K (approximate) 


RA80 disk 


DU 


220K (approximate) 


Virtual memory 


VM 


Variable, depending 
on physical memory 
available 


Logical disk 


LD 


Variable 



Map Output Device 

The map output device receives the link maps that result from the linking 
process. It is sometimes useful to list the link maps on the terminal or a 
line printer, in which case you should specify TT: or LP:, respectively, for 
the map output device. 
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If you specify the name of a block-replaceable device, such as a disk, you 
can send the link maps as files to that device. Send the link maps to a disk 
(instead of a terminal or line printer) so that you will be sure they are 
saved. DIGITAL requires that you include a link map and answer file list- 
ing whenever you submit a Software Performance Report (SPR) for a moni- 
tor created by SYSGEN. 

You can suppress the link maps altogether by sending the output to the 
null device (answer NL: to the SYSGEN question "What is the PHYSICAL 
name of the map output device?"). However, DIGITAL strongly recom- 
mends saving the link maps. 

Figure 1-3: All Files on One Disk for System Build 
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Figure 1-4: Source Files on Second Disk for System Build 
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Figure 1-5: Second Disk and Line Printer Receive System Build 
Output 
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1.2.5.2 Manual System Build — You may need to use a sequence of individ- 
ual commands to build the system or one or more components of the system. 
Use this manual method if you do not have enough mass storage space to 
execute the entire command file or if you need to rebuild a particular com- 
ponent because an error occurred when you built it. 

In this case, specify devices included in your configuration. (Refer to the 
questions asking for physical device names in the "Physical Device Selec- 
tion and SYSGEN Cleanup" section of the SYSGEN dialog.) However, you 
need not plan the arrangement of files on SRC:, BIN:, and MAP:, since you 
will not be using the indirect command files SYSGEN.MON, SYS- 
GEN.DEV, and SYSGEN.BLD to build the system automatically. You will 
need the indirect files for information, and you will need to arrange specific 
files on diskettes in order to perform the system build procedure. 

If you intend to perform the system generation process on an RX01 or RX02 
diskette system, you will have to use the manual system build procedure, 
because you cannot fit all the required files on two diskettes. Consequently, 
you must arrange the files so that you can copy them to your system vol- 
ume a few at a time and perform the component assemblies. Chapter 3 
provides step-by-step procedures for generating special monitors and han- 
dlers on diskette systems. Those procedures require a special organization 
of files on diskettes for the assembly procedure. Study Chapter 3 if you need 
to use manual system build procedures. 

1.3 Studying the SYSGEN Dialog 

The SYSGEN dialog is reproduced here so that you can study it. When you 
run the program SYSGEN.COM, most of this dialog prints on your termi- 
nal. Some dialog questions appear only if you answered a previous question 
in a specific way. Therefore, SYSGEN may not ask you all the questions 
shown in this dialog. 

Default answers are shown in parentheses. If you respond to a question by 
pressing only ©, the default answer is used. 

The following dialog that prints on your terminal when you run SYSGEN 
appears below as actual computer output. Additional information follows 
the actual SYSGEN dialog. 

a***************** ****************** *************************** 

RT-11 SYSTEM GENERATION PROGRAM M05.00 
a***.*****.********************************* ********************* 

Do you want an introduction to system feneration (N>? 

Type "Y" for a detailed explanation of the system feneration 
process. 
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Respond YES if you want to read an introduction to the system generation 
process. 

The System Generation (BYSGEN) prosram functions as an inter- 
active dialog in which the program asks you a series of 
questions. Your answers establish the characteristics and 
features of the monitor(s) and device handlers that the pro* ram 
Generates. SYSGEN prints each question and waits for your 
response. You can reply i (time d i at e 1 y with a valid response* or 
you can obtain a detailed explanation of the question by typing 
the ESCAPE key followed by the RETURN key. You can prevent 
SYSGEN from printing the entire explanation by typing <CTRL/0> 
at any time during the explanation. SYSGEN then stops printing 
the explanation* prints the question* and waits for your 
response. 

SYSGEN can generate one or more monitors from the output of one 
dialog session* depending on the responses you give. However* 
your responses during a session apply to all the monitors 
generated during that session. 

The system generation process produces two conditional files and 
three indirect command files as output. To produce these files* 
the SYSGEN dialog asks you questions about the target system 
configuration and about monitor and device support options you 
want. To be able to respond effectively* you should read the 
RT-11 SYSTEM GENERATION GUIDE before proceeding. 

The dialog simply asks a question and waits for your response. 
Although the dialog questions are sequentially numbered* certain 
responses cause SYSGEN to skip some questions which do not apply 
for the system you are generating. 

Dialog questions require one of several types of responses. 
Responses may be in the form of a character string* a number* or 
YES/NO (Y/N). SYSGEN expects a decimal number for all numeric 
answers except for CSR and vector addresses? in these cases it 
expects an octal number. A default response* in parentheses* 
fallows each question. If you choose to use the default 
response* type only RETURN in response to the question. 

To terminate SYSGEN at any time* type <CTRL/C>. 

Do you want to use a previously created answer file (N)? 

SYSGEN can use commands and responses contained in an answer file 
to determine the characteristics of the monitors and device 
handlers for your target system. If you choose to use an answer 
file* SYSGEN uses the responses in the answer file instead of 
printing the interactive dialog to obtain your responses. 

Answer files that create the distributed monitors and handlers 
are included on the RT-11 distribution kit. You can also use 
answer files that you have created during earlier system gener- 
ation sessions. 

What answer file do you want to use ( SYSGEN . ANS ) ? 

Type the device* filename and filetype of the answer file you 
want to create. Use the following format for your responses 

ddnifilnam.typ 

The variable ddn is the device name and unit number where the 
answer file is to reside* and filnam.typ is the filename and 
filetype of the answer file you are creating. 
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If the specified answer file cannot be found, has an invalid file name, or 
cannot be accessed, SYSGEN issues an appropriate error message. 

Do you want to create an answer file (N)? 

Type Y to create an answer file that reflects the responses you 
make durins this session. This answer file can be used during a 
later SYSGEN session. 

What answer file do you want to create ( SYSGEN .ANS ) ? 

Type the device* filename and filetype of the answer file you 
want to create. Use the following format for your response: 

ddn : f i lnam. tvp 

The variable ddn is the device name and unit number where the 
answer file is to reside* and filnam.typ is the filename and 
filetype of the answer file you are creatine. 

If the specified answer file already exists or is invalid, SYSGEN prints the 
following warning message and question: 

?SYSGEN-W-Fi le already exists ddn : f i lnam . typ 

Do you want to create a new SYSGEN. ANS file (N)? 

A file already exists with the same name as the answer file you 
have chosen to create. If you still want to use this name for 
your output answer file* the data contained in the already 
existing file of the same name will be lost. 

SYSGEN now checks for protected output files and prints: 

...checkinS for protected output files. 

If any are protected, SYSGEN prints: 

?SYSGEN-F-Protected file already exists <filename> 

**************************************************************** 

MONITOR TYPE 
♦a************************************************************** 

You must respond YES to at least one of questions 1 through 3. Each 
SYSGEN run must build at least one monitor. You cannot build device 
support without building a monitor. 

1. Do you want the sinale-Job (SJ) monitor (Y)? 

SINGLE-JOB MONITOR: 

The sinSle-Job (SJ) monitor provides an environment suitable for 
developing simple FORTRAN or BASIC applications. The SJ monitor 
includes many of the same features as the fo re 3 round/back 3 round 
(FB) monitor — it supports all hardware devices (except the memory 
management unit)* all programmed requests (except .MRKT and 
.CMKT)* and all the utility programs. It offers the most features 
in the smallest size. You can add features during SYSGEN* but at 
the cost of increased monitor size. 
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Respond YES if you want to generate an SJ monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. In addition, Appendix A in this manual gives the SYSGEN an- 
swers that will duplicate the distributed monitors. 

2. Do you want the fo re g round/back g round (FB) monitor (Y)? 

FOREGROUND/BACKGROUND MONITOR: 

The fo res round/back Ground (FB) monitor offers an extended set of 
features that aid real-time or data acquisition applications. In 
addition to the foreground Job capability* this monitor supports 
serialized asynchronous I/O and additional programmed requests 
(including .MRKT and .CMKT), 

Respond YES if you want to generate an FB monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. 

3. Do you want the extended memory (XM) monitor (N)? 

EXTENDED MEMORY MONITOR: 

The extended memory (XM) monitor* which supports lip to 124K words 
of memory* is a version of the FB monitor. It requires KT11 
hardware (the memory management unit) and the extended instruc- 
tion set (EIS). The XM monitor supports additional programmed 
requests that allow you to extend a program's logical addressing 
space. However* the XM monitor is larger than the FB monitor and 
requires that the user service routine (USR) be resident. 

Respond YES if you want to generate an XM monitor. Review Section 1.1.2 
of the RT-11 Installation Guide to compare the advantages of the various 
monitors. 

***##***#**#*#*#♦*#**###*♦#**###**#* ***#***#*.*******#****#***** 

MONITOR OPTIONS 

Note that when you select certain options, SYSGEN automatically enables 
other options, even if you respond NO to the questions. For example, if you 
respond NO to SJ timer support and device timeout support but YES to 
multiterminal support, SYSGEN enables SJ timer support and device 
timeout support anyway. 

4. Do you want timer support in the SJ monitor (N)? 

SJ TIMER SUPPORT OPTION: 

The SJ monitor normally does not include timer support. You can 
include this support* which enables you to use the .MRKT (mark 
time) and .CMKT (cancel mark time) programmed requests. 

Respond YES if you want to use the .MRKT and .CMKT programmed re- 
quests with the SJ monitor. The FB and XM monitors support these pro- 
grammed requests, which provide timer capability. However, you must spe- 
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cifically select this support for SJ, since it adds approximately 360 (deci- 
mal) words to the resident monitor. Timer support reduces response time 
slightly because of the additional interrupt-level overhead. If your applica- 
tion requires timer support, you must select it. Note also that the SJ moni- 
tor increments the date at midnight only if you select this support. RT-11 
does not require it. 

5. Do you want device time-out support <N)? 

DEVICE TIME-OUT SUPPORT OPTION: 

The device time-out option permits device handlers to issue .MRKT 

(mark time) programmed requests. DECnet support requires this 

option. 

Respond YES if you are a DECnet user or if your application uses device 
timeout support. RT-11 does not use this support. This support adds ap- 
proximately 40 (decimal) words to the resident FB and XM monitors; it 
adds approximately 360 (decimal) words to the resident SJ monitor, since 
enabling this support automatically enables SJ timer support. 

B . Do ■/ o u want an error message on system I/O errors ( Y ) ? 

ERROR MESSAGE ON SYSTEM I/O ERRORS OPTION: 

The SJ monitor normally halts if a fatal system I/O error occurs. 
You can replace this halt with a system error message. DIGITAL 
highly recommends this option if the system will be used by 
anyone but the most experienced individuals. 

Respond YES if you want an error message instead of a system halt when 
the SJ monitor detects a fatal I/O error. Although this option adds approxi- 
mately 30 (decimal) words to the resident monitor, DIGITAL strongly 
recommends this option for all but the most space-conscious applications. 
The confusion this option saves is well worth the small amount of addi- 
tional memory it requires. The FB and XM monitors include this support. 

7 ♦ Do you want system Job support (N)? 

SYSTEM JOB OPTION: 

The system Job option allows you to run up to eisfht simultane- 
ously active Jobs. The error logger and the QUEUE program can be 
either foreground Jobs or system Jobs. If you want to run both 
simultaneously f or if you want to run either one along with a 
foreground Job* you need system Job support. 

Respond YES if you want system job support. You need this support if you 
use the error logger or the device queue program (QUEUE) as well as a 
foreground job, or if you use both the error logger and QUEUE. (Note that 
you need not select system job support if you intend to run the error logger 
only under the SJ monitor.) You can also use system job support to create 
application-specific system jobs. This support adds approximately 300 (deci- 
mal) words to the resident monitor. 
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B. Do you want to use the .SPCPS request (N)? 

SAVE/SET MAIN-LINE PC AND PS OPTION: 

The save/set main-line PC and PS option is a conditionally 
assembled programmed request for the FB and XM monitors. The 
, SPCPS request changes the flow of control of main-line code by 
savins the main-line code PC and PS and chansinsf the main-line PC 
to a new value. This request may be useful in multi-user 
applications to control switchins anions' users. 

Respond YES if you want to use the .SPCPS request. Refer to the RT-11 
Programmer's Reference Manual for more information about this pro- 
grammed request. 

9. Do you want multiterminal support (N)? 

MULT I TERMINAL SUPPORT OPTION: 

The multiterminal option lets you use special programmed 
requests to do I/O to more than one terminal, RT-11 normally 
supports only one terminal interfaced through the console (DL11) 
which is shared by both background and foreground Jobs. You can 
select multiterminal support for up to IB terminals interfaced 
throush a choice of DL11 and DZ11 interfaces, Subsequent 
questions will establish the number and type of interfaces. Note 
that if you choose multiterminal support your system cannot 
support YTli or MSGO Graphics. 

Respond YES if you want multiterminal support and are generating an SJ, 
FB, or XM monitor. This option selects monitor support for up to 16 termi- 
nals. However, if the application itself provides support for additional ter- 
minals and if you require only console support in the monitor, you should 
not select this support. MU BASIC-11 requires that you respond YES to 
this question. 

You need not select multiterminal support to use a hard copy terminal as a 
line printer. You need only the serial line printer handler, LS.SYS, which 
is included in the software kit. 

Multiterminal support adds considerably to the space requirements of the 
resident monitor. It adds a minimum of 750 (decimal) words for the first 
additional terminal and approximately 100 (decimal) words for each addi- 
tional terminal. However, the exact number of words added depends on the 
interfaces, the configuration, and the other options you select. 

10. Do you want asynchronous terminal status (Y)? 

ASYNCHRONOUS TERMINAL STATUS OPTION: 

The asynchronous terminal status option provides a program with 
the updated status of a terminal and modem. When a program 
attaches a terminal* the program can supply a status word that 
the monitor updates as changes occur in the terminal status 
(double CTRL/C » input available* output buffer empty* carrier 
present). This support is required for MU BASIC applications. 
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Respond YES if you are an MU BASIC user or if your application uses 
asynchronous terminal status information. If you are in doubt about this 
option, respond YES. This support applies only to multiterminal applica- 
tions, so SYSGEN asks you this question only if you respond YES to ques- 
tion 9. 

lit Do you want multiterminal time-out support (Y>? 

MULTITERMINAL TIME-OUT OPTION: 

Multiterminal time-out support causes the monitor to reset (at 
regular intervals) any terminal that may have Sone off-line* 
This action helps to minimise the impact of static and similar 
problems. DIGITAL recommends selecting this option if your 
application requires maximum terminal availability. 

Respond YES for maximum terminal availability. If you are an MU 
BASIC-11 user, be sure to select this support. 

This support applies only to multiterminal applications, so SYSGEN asks 
you this question only if you respond YES to question 9. DIGITAL recom- 
mends that you select this option unless you have space problems. 

12. Enter the size of the output buffers (40): 

OUTPUT RING BUFFER SIZE OPTION: 

The RT-11 terminal service requires a set of output rins buffers 
for each supported terminal. The output rins is a buffer in the 
monitor that holds characters until the terminal can print them. 
(A pros ram can send characters faster than a terminal can print 
them. ) 

Respond with the number (decimal) of characters that you want the moni- 
tor to hold in the output ring buffers. Each character adds n bytes to the 
resident monitor size, where n is the total number of terminal lines. Note 
that you must count the carriage return and line feed combination as two 
characters. The range for valid responses is from 10 to 134. 

13. Enter the size of the input buffers (134): 

INPUT RING BUFFER SIZE OPTION: 

The RT-11 terminal service requires a set of input rinsf buffers 
for each terminal supported. The input rinsf is a buffer in the 
monitor that holds the characters that you type at a terminal 
until a program requests them. You may want to change the input 
rinu size, in particular, since the size you need depends on the 
terminal's width and the amount of type-ahead you expect. 

Respond with the number (decimal) of characters that you want the moni- 
tor to hold in the input ring buffers. If you specify an odd number of charac- 
ters, SYSGEN rounds the number down. Each character adds n bytes to the 
resident monitor size, where n is the total number of terminal lines. 
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You should make the input ring buffers large enough to hold at least one 
line of input. If the largest line accepted by an application is greater than 
134 characters, you can adjust the size of the input buffers. 

The minimum acceptable input buffer size is 74 characters. If you specify 
less than 74, an error occurs at monitor assembly time. The monitors re- 
quire 82-character buffers for efficient command operation. Buffers larger 
than 82 characters are useful if you anticipate using the type-ahead fea- 
ture. 

The RT-11 keyboard monitor and the .GTLIN programmed request accept 
up to 80 characters. However, if your program uses the VT100 132-charac- 
ter mode, you should select support for an input ring buffer of 134 charac- 
ters. 

The range for valid responses is from 74 to 254. 

14. Do vou want to use the .FETCH request under KM (Y)? 

If you choose .FETCH support under XM » then device handlers can 
be fetched by user b a c K s r o u n d programs. Also. pre-Version 5 
programs which do not use the form of the .PROTECT directive 
which includes automatic vector setup must be modified to do so. 
If you do not select this option » all in-line service routines 
would* as in Version H > have to remain clear of the memory mapped 
by kernel APR 1 and handlers must be loaded before use. 

15. Do you want end of month and year date rollover (N)? 

MONTH ROLLOVER OPTION: 

When you run a system continuously, over a Ions period of time, 
you normally have to reset the date and time at the besinnins of 
each month. You can select a feature that automatically sets the 
correct date and time. However, this option greatly increases the 
size of the monitor. 

Respond YES if you want the date automatically reset at the beginning of a 
month or year and if space is not a serious concern. This option adds ap- 
proximately 50 (decimal) words to the resident monitor. 

17, Do you want the user command linkaSe(N)? 

USER COMMAND LINKAGE 

The user command linkage allows you to define your own commands 
which can be issued in a format similar to the standard DCL 
commands . 

19. Do you want h i S h speed r i n S buffer support (N)? 

HIGH SPEED RING BUFFER 

When the h i 3 h speed r i n 3 buffer is present, all character 
processing and interpretation is performed at fork level. The 
advantage of havins the hish speed r i n S buffer is that it allows 
short bursts of characters c o m i n S in at a very hish rate. This is 
useful for systems with VT100 or other terminals that report 
their status by send ins a burst of information to the host 
computer. Use of the hish speed r i n s buffer is especially 
recommended with a PDT. 
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20. Do you want all the keyboard monitor commands (Y)? 

KEYBOARD MONITOR COMMANDS OPTION: 

The Keyboard monitor commands option lets you choose the Keyboard 
monitor commands your generated monitor will support. You will 
probably find all of the commands useful. However* you can 
reduce KMON size and assembly time if you select support for a 
subset of the available commands. You have a choice of three 
subsets (or any combination of subsets). The three command 
subsets /ou can choose are: the UTILITY PROGRAM COMMANDS* the 
LANGUAGE COMMANDS* and the MINIMAL COMMANDS. If you do not 
choose the complete set of commands or any of the subsets* you 
will be able to use only the RUN command. 



Respond YES if you want support for all the keyboard monitor commands. 
All the commands available with RT-11 are in the following list. If you 
choose the complete set of keyboard commands, the disk (or other device) 
file image of the SJ monitor is increased by 14 blocks and the image of the 
FB or XM monitor by 18 blocks. If you choose one of the subsets, the moni- 
tor disk file images will be smaller. 

NOTE 

If you want just one or several commands, select the appro- 
priate conditionals in Appendix C and edit SYSGEN.CND. 



ABORT 

BASIC 

COPY 

DEASSIGN 

DIRECTORY 

EDIT 

FRUN 

INITIALIZE 

LOAD 

PROTECT 

RENAME 

SAVE 

SRUN 

TYPE 



ASSIGN 

BOOT 

CREATE 

DELETE 

DISMOUNT 

EXECUTE 

GET 

INSTALL 

MACRO 

R 

RESET 

SET 

START 

UNLOAD 



B 

CLOSE 

D 

DIBOL 

DUMP 

FORMAT 

GT 

LIBRARY 

MOUNT 

REENTER 

RESUME 

SHOW 

SUSPEND 



BACKUP 

COMPILE 

DATE 

DIFFERENCES 

E 

FORTRAN 

HELP 

LINK 

PRINT 

REMOVE 

RUN 

SQUEEZE 

TIME 



UNPROTECT 



21. Do you want the UTILITY subset (Y)? 

The following commands are included when the UTILITY commands 
are chosen: 



BACKUP 


BOOT 


COPY 


CREATE 


DELETE 


DIFFERENCES 


DIRECTORY 


DUMP 


EDIT 


FORMAT 


INITIALIZE 


PRINT 


PROTECT 


RENAME 


SHOW 


SQUEEZE 


TYPE 


UNPROTECT 







Type Y if you want support for the UTILITY subset of the 
Keyboard monitor commands. Type N if you do not want the subset 
or if you wish to specify individual commands by editing the 
SYSGEN.CND file after this session. 
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Choosing this subset increases the size of the disk (or other device) image of 
the monitor file by only six blocks (rather than the 14 to 18 blocks for all 
the commands). Note that you can select more than one subset; SYSGEN 
asks you about the other subsets. However, SYSGEN does not ask this 
question if you respond YES to question 20. Note also that the R and RUN 
commands cannot be removed; they are included in all the sets of com- 
mands. 

22. Do you want the LANGUAGE subset (Y>? 

The following commands are included when the LANGUAGE commands 
are chosen: 

BASIC COMPILE DIBOL EXECUTE 

FORTRAN LIBRARY LINK MACRO 

Type Y if you want support for the LANGUAGE subset of the 
Keyboard monitor commands. Type N if you do not want the subset 
or if you wish to specify individual commands by editing the 
SYSGEN. CND file after this session. 

Choosing this subset increases the size of the disk (or other device) image of 
the monitor file by only four blocks (rather than the 14 to 18 blocks for all 
the commands). Note that you can select more than one subset. SYSGEN 
does not ask this question if you respond YES to question 20. The default 
response to this question is YES. 

23. Do you want the MINIMAL subset (Y)? 

The following' commands are included when the MINIMAL commands 
are chosen: 



ABORT 


ASSIGN 


B 


CLOSE 


D 


DATE 


DEASSIGN 


DISMOUNT 


E 


FRUN 


GET 


GT 


HELP 


INSTALL 


LOAD 


MOUNT 


R 


REENTER 


REMOVE 


RESET 


RESUME 


RUN 


SAUE 


SET 


SRUN 


START 


SUSPEND 


TIME 


UNLOAD 









Type Y if you want support for the MINIMAL subset of the 

Keyboard monitor commands. Type N if you do not want the subset 

or if you wish to specify in dividual commands by editing the 
SYSGEN. CND file after this session. 

The execution code for all the commands in the MINIMAL subset is resi- 
dent in KMON. If you select this option but do not select FB or XM monitor 
support, SYSGEN does not include the commands FRUN, RESUME, and 
SUSPEND. If you select this subset but do not select support for VT-11 
graphics display, SYSGEN does not include the GT command. If you do not 
select system job support, SYSGEN does not include the SRUN command. 
Note, however, that you can select more than one subset. Choosing this 
subset increases the size of the disk (or other device) image of the SJ moni- 
tor file by only six blocks and the FB or XM monitor file by only 10 blocks 
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(rather than the 14 to 18 blocks for all the commands). SYSGEN does not 
ask this question if you respond YES to question 20. 

24. Do you want the optional 50 Hz clocK support (N)? 

50 HZ CLOCK OPTION: 

A line clock Generates periodic interrupts to allow the system to 
Keep tracK of the time. The number of ticks per second depends on 
the power line frequency. 60 Hz or 50 Hz. RT-11 assumes a 80 Hz 
line frequency, but you can select support for a 50 Hz clock. The 
50 Hz frequency has specialized uses and is the common frequency 
in Europe. 

Respond YES if your computer's line frequency is 50 Hz. 

25. Do you want to use the KW11-P clock as the system clock (N)? 

PROGRAMMABLE CLOCK AS SYSTEM CLOCK OPTION: 

RT-11 normally uses a line clock for the system clock. You can 
substitute the KW11-P programmable clock as the system clock, but 
the KW11-P will not then be available for program use. The 
programmable clock normally allows you to program interrupts at 
preset intervals. 

Respond YES if your configuration includes the KW11-P clock and you 
want to use it as the system clock. The monitor uses the system clock for 
certain functions (time-of-day calculations, timer requests, and FB and XM 
scheduling). If the system clock is the programmable clock, your applica- 
tion cannot access the programmable clock or change its rate without af- 
fecting monitor function. Therefore, DIGITAL recommends that you use a 
line clock, if available, for the system clock. 

2B. Do you want the start-up indirect file (Y)? 

STARTUP INDIRECT COMMAND FILE OPTION: 

This option causes the bootstrap to execute an indirect command 
file (with the name STARTx.COM. where x identifies the monitor) 
when starting the system. An indirect command file contains 
monitor commands that the monitor processes (in the order in 
which they appear) when the file is executed. A startup indirect 
command file is particularly useful for setting up initial 
conditions (for example, assigning the default device to the data 
device, installing a device into the system tables when the 
device was not originally built into the system, or running- a 
specific program). 

Respond YES if you want the monitor bootstrap to execute a start-up indi- 
rect file every time you boot the system. If you select this support, the 
bootstrap looks for a file STARTx.COM to execute (where x is S, F, or X for 
single-job, foreground/background, or extended memory monitor). You cre- 
ate this file, with commands to perform whatever operations you choose. If 
no STARTx.COM file resides on a volume, the monitor prints an error 
message when you boot that volume. This option requires no additional 
resident monitor space. 



Preparing for System Generation 1-27 



27. Do you want floating point support (Y)? 

FLOATING POINT OPTION: 

If your configuration includes floating point hardware and your 
application requires this feature* you should enable this option. 
Floating point hardware is available for many PDP-11 processors. 
This is especially useful for FORTRAN K' and BASIC-11 users whose 
applications perform data manipulations. 

Respond YES if your configuration includes the appropriate hardware and 
your application uses floating point manipulations. If you try to perform 
floating point manipulations but have not selected this support, system 
failure results. 

If you select this support, the monitor intercepts all floating point traps. If 
your program has not set up an exception handler, the monitor prints an 
informative message and aborts the program. If your program has set up an 
exception handler, that routine is entered with the FPU status (if appropri- 
ate) on the stack. The monitor makes sure that the correct job's context is 
set up. 

In addition, if you select floating point support, the .SFPA programmed 
request (refer to the RT-11 Programmer's Reference Manual) is enabled. If 
you do not choose floating point support, none of the functions of .SFPA is 
performed; for example, the floating point registers are never context 
switched. 

If you do not include floating point support, all programs that use the 
floating point instructions must set up and .PROTECT or .CNTXSW the 
vector. FORTRAN IV requires monitor floating point support if you use one 
of the floating point libraries. 

Floating point support adds approximately 200 (decimal) words to the resi- 
dent SJ and FB monitors and approximately 300 (decimal) words to the 
resident XM monitor. 

28. Do you want memory parity support (N)? 

MEMORY PARITY SUPPORT OPTION: 

If your configuration includes me Mary parity hardware* you should 
select this option. Memory parity hardware checks for memory 
errors and this option enables RT-11 support for the hardware. 
RT-11 issues an error messase and supplies the location of access 
when a memory error occurs. If you haue this hardware but do not 
enable this support, the system halts when memory errors occur. 
If you select error losfsfinS as well as memory parity support* the 
error lossfer loss parity errors as well as device errors. 

Respond YES if your configuration includes memory parity hardware. 
Memory parity support adds approximately 8 (decimal) words to the resi- 
dent SJ monitor and approximately 25 (decimal) words to the resident FB 
and XM monitors. If you have this hardware, you need RT-11 memory 
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parity support both to make use of the hardware's capabilities and to avoid 
unwanted system halts. 

29. Do you want power failure messages (N)? 

POWER FAILURE MESSAGE OPTION: 

The Monitor normally halts on power recovery startup after a 

power failure* You can elect to have the monitor print a messaSe 

explain in S that power failure caused the halt. However* you Must 

not select this option if you have semiconductor Memory* which is 

volatile. 

Respond YES if you want an error message on start-up after system halt to 
report the cause of the halt. Select this option only if your hardware config- 
uration includes core memory or battery backup, not semiconductor mem- 
ory (which is volatile). This option adds approximately 90 (decimal) words 
to the resident monitor. However, DIGITAL strongly recommends this op- 
tion, since it quickly identifies the cause of failure. Frequently, system 
halts are caused by power failures too brief to detect visually. 

30. Do you want BATCH support <N)? 

BATCH SUPPORT OPTION! 

You can select support for the BATCH Job control laniuaJei which 
allows RT-11 to operate unattended. Once you prepare a BATCH 
stream > you can leave it for an operator to start and run* and 
the BATCH streaM will execute programs or monitor commands 
without your intervention. Indirect command file support* which 
offers sifflilar capabilities* is separately available in all 
monitors. You need not select BATCH support to obtain indirect 
command file support. 

Respond YES if you want BATCH support. RT-11 BATCH support is simi- 
lar to indirect command file support, but it offers certain advantages. 
BATCH produces a log file, allows job-stream programmability, and per- 
mits the operator to interact with the job during execution. Unless you need 
the features not provided by indirect command file support, you need not 
select this support. 

31. Do you want error 1 o 3 3 i n 3 (N>? 

ERROR LOGGING OPTION! 

The error 1 o 3 3 i n 3 option creates the error 1 o 3 3 i n 3 (EL) system 
job* and incorporates error 1 o 3 3 i n 3 support in the device 
handlers. Error 1 o 3 3 i n 3 reports device* memory parity (if 
selected)* and Memory cache errors. When error lo33in3 is 
enabled* most device handlers call EL on each successful transfer 
and on each error. The EL Job retrieves information from the 
handlers that is later available to you in summary report format. 

Respond YES if you want to use the error logging system job. This option 
adds approximately 2000 (decimal) words to the resident monitor and 50 
(decimal) words to each device handler you generate. However, error log- 
ging is useful in monitoring system reliability. 
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32. How many device units does error 1 o sf Job support (10)? 

NUMBER OF UNITS SUPPORTED BY ERROR LOGGING OPTION: 
The error loSier can handle up to 34 individual device units. 
You can conserve space by reducing the number of units the logger 
can handle to the specific number of supported units in the 
target configuration. 

Respond with the number (decimal) of supported device units in the system 
you are generating. For example, if the target system has three RK05 
drives and a dual diskette drive, the response is 5. Each unit adds seven 
words to the error logger. The range for valid responses is from 1 to 34. 
SYSGEN asks this question only if you respond YES to question 31. 

#*##****#**#*****##**#*##*****#**#**##*#*##*******♦*#**# #**#**#* 

DEVICE OPTIONS 
***#******#*##*****#♦####*****###*##***###********# ****** ******# 



Type <ESCAPE> < 
Type ?<RETURN> 
Type ,<RETURN> 



RETURN> for 
to list all 
when device 



help. 
devices. 

selection 



is complete. 



Enter the device name you want support for [ d d 3 : 

The device options let you select the peripheral devices that the 
generated system will support. By selecting support for a 
specific device* you make the device Known to the monitor's 
device tables, and SYSGEN generates a device handler named 
xx.SYG* (where xx is the physical device name) for the device. 
If you do not select a specific device at this timet you will 
have to create the device handler separately and use the monitor 
INSTALL command before you can access the device. 

The following is a list of the valid RT-il devices and their 
associated device names. SYSGEN will display the device name 
list each time you type a question m a r K (?) followed by a 
carriage return in response to the device name question. An 
asterisK (*) will precede the device name if selected. Type a dot 
when you have entered all the device names you want support for. 

Do you want a list of available devices ( Y ) ? 



A YES response causes SYSGEN to list all valid RT-11 devices and their 
associated device names. An asterisk (*) precedes those devices for which 
support has already been selected. Valid RT-11 devices are: 



DX RX01 Single-Density Diskette DY 

DD TU58 DECtape II RK 

DL RL01/RL02 Cartridge Disk DM 

MT TM11 (UNIBUS) Magtape MM 

MS TS11 (UNIBUS) Magtape NL 

LP Line Printer LS 

DU MSCP Disk Class Handler LD 

VM Virtual Memory Handler 



RX02 Double-Density Diskette 
RK05 Cartridge Disk 
RK06/RK07 Cartridge Disk 
TJU16 (MASSBUS) Magtape 
Null Handler 
Serial Line Printer 
Logical Disk Handler 



33. Do you want support for a second < device)- controller (N>? 

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or 
DECtape II (DD) support. 
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The <RX01/02 disKette or TU58 cartridse> subs/stem supports only 
two drives for each controller. If your system contains four 
drives* a second controller governs the third and fourth 
units* and you must select RT-il support for it. 

Respond YES if your target configuration includes four <device> drives. 
Note that you can boot RT-11 only from Unit or Unit 1. 

34. Do you want RX02 double density only support (N)? 

The RX02 diskette supports both single and double densities by 
default. If you select double-density only support* you can 
slightly improve the performance and reduce the size of the 
device handler. 

Respond YES if you plan to use only double-density diskettes. SYSGEN 
asks this question only if you request RX02 (DY) support. 

35. What is the CSR address for the <nth> <device> (nnnnnn)? 
The valid range for the CSR address is from 160000 to 177570. 

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or 
DECtape II (DD) support. Respond with the appropriate CSR address(es) 
for the device controller(s). The field service representative who installs 
your hardware system is responsible for supplying you with a written rec- 
ord of addresses at which he or she installs each device. The default (octal) 
addresses appear in parentheses. 

36. What is the vector address for the <nth> <device> (nnn)? 

For the first and second RX01, RX02, and DECtape II controllers: 

The valid range for the vector address is from 100 to 474. 

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or 
DECtape II (DD) support. Respond with the appropriate vector address(es) 
for the device controller(s). The field service representative who installs 
your hardware system is responsible for supplying you with a written rec- 
ord of addresses at which he or she installs each device. The default (octal) 
addresses appear in parentheses. 

37. How many disk platters are installed on the RF11 (1)? 

Respond with the number (decimal) of RF11 platters included in 
your RF11 subsystem. The range of valid responses is from 1 to 8. 

SYSGEN asks this question only if you request RF11 support. 

38. Do you want RJS03 rather than RJS04 support (Y)? 

Type Y if your target system includes an RJS03 disk subsystem 
rather than an RJS04. 
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If your response is NO, SYSGEN prints the following message: 

RJS04 support assumed. 

SYSGEN asks this question only if you request RJS03/04 MASSBUS fixed- 
head disk support. 

39. How many RL01/RL0Z units are to be supported (2)? 

Enter the number (decimal) of RL01/RL02 units included in your 
RL01/RL02 subsystem. The ranSe of valid responses is from 1 to 4. 

SYSGEN asks this question only if you request RL01/RL02 cartridge disk 
support. 

40. Do you want RPR02 rather than RPR02/RP03 support (N)? 

Type Y if your tarSet system includes an RPR02 disk subsystem 
rather than RPR02/RP03. 

If your response is N, SYSGEN prints the following message: 

RPR02 and RP03 support are assumed 

SYSGEN asks this question only if you request RP1 1 support. 

41. Do you want the file-structured m a s t a p e handler (Y)? 

FILE-STRUCTURED MAGTAPE OPTION: 

RT-11 masftape support is auailable in two forms. The standard 
form is file-structured masftape support » which uses a subset of 
ANSI file format. The file-structured handler stores and 
retrieves data in a file format usable with most RT-11 system 
programs. The second form of masftape support* hardware handler 
support* omits file structuring and reads and writes data 
directly in variable length records. While this handler is sig- 
nificantly smaller than the file-structured handler* you cannot 
use it with any system programs. The file-structured handler can 
also perform direct hardware functions. 

Select this option only if you intend to use any of the system programs, 
RT-11 commands, FORTRAN IV programs, or BASIC-11 programs with 
the magtape. 

42. How many masftape units are to be supported (2)? 

NUMBER OF MAGTAPE UNITS OPTION: 

The masftape handler requires table space for each masftape unit. 
You can minimize the size of the mast ape handler by limiting the 
number of units it can simultaneously handle to the number 
actually present on the target machine. 

Respond with the number (decimal) of magtape drives included in your 
magtape subsystem. SYSGEN asks this question only if you responded 
YES to question 41. The range for valid responses is from 1 to 8, and the 
default response is 2. 
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43. What is the address of the < n t h > unit (nniinnn)? 

Each TSil unit requires two contiguous UN I BUS addresses for 
status registers. Enter the address (octal) of the <nth> unit. 
The ransfe of valid responses is from 160000 to 177570. 

If you request TS11 support, SYSGEN asks questions 43 and 44 once for 
each TS11 tape unit you wish to support. SYSGEN asks you for the ad- 
dresses of as many units as you specified. Respond with the address (octal) 
of each TS11 unit. The field service representative who installs your hard- 
ware system is responsible for supplying you with a written record of ad- 
dresses at which he or she installs each device. 

Up to eight TS11 controllers can be supported. Default status register ad- 
dresses and vector addresses are as follows: 



Magtape Unit Register Address Vector Address 

1 172522 224 

2 172526 300 

3 172532 304 

4 172536 310 

5 172542 314 

6 172546 320 

7 172552 324 

8 172556 330 

44 . What is the vector address of the < n t h > unit (mm)? 

Enter the vector address (octal) of the first unit. The ranse for 
valid responses is from 100 to 474. 

45. Does your printer have a nonstandard vector or CSR ( N ) ? 

The standard line printer vector address is 200 and the standard 
CSR address is 177514. If your printer is installed at another 
vector or CSR address* specify the correct values. 

Respond YES if the line printer control register address is not 177514 or 
the vector address is not 200. These addresses usually are nonstandard only 
if the printer is an LA180S. 

SYSGEN asks this question only if you request parallel line printer (LP) 
support, and asks questions 46 and 47 only if the response is YES. 

4G. What is the CSR address for the printer (177514)? 

Respond with the address of the control register for the line 
printer. The ransfe for valid responses is from IS 0000 to 177570. 



The field service representative who installs your hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 

SYSGEN asks this question only if the answer to question 45 is YES. 
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47 . What is the vector address for the printer (200)? 

Respond with the vector address for the line printer. The ranse 
for ualid responses is from 100 to 474. 

SYSGEN asks this question only if the answer to question 45 is YES. 

48. What is the CSR for the serial line printer (176500)? 

Respond with the address of the control register for the serial 
line printer. The ranSe for valid responses is from 1B0000 to 
177570. 

SYSGEN asks this question only if you request serial line printer (LS) 
support. The field service representative who installs your hardware sys- 
tem is responsible for supplying you with a written record of addresses at 
which he or she installs each device. 

49. What is the vector for the serial line printer (300)? 

Respond with the vector address for the serial line printer. The 
ransfe for valid responses is from 100 to 474. 

SYSGEN asks this question only if you request serial line printer (LS) 
support. 

Do you want to add support for any of your own devices (N)? 

SYBGEN will Generate commands to assemble and linK any user 
supplied device handlers. SYSGEN also adds the device names to 
the system device tables in SYSGEN. TBL. 

Type <ESCAPE> <RETURN> for help. 

Type ?<RETURN> to list all devices. 

Type .<RETURN> when device specification is complete. 

Enter the device name you want support for C d d ] : 

Enter the 2 character device name for the device for which you 
are supplyins a device handler. 

50. How many extra device slots do you want ( ) ? 

EXTRA DEVICE SLOT OPTION! 

SYSGEN allocates space in the monitor for only the devices 
specified. You can allocate additional space by requesting 
empty device slots. Allocate one empty slot for each device you 
intend to add to the system after it is built. Also Keep in mind 
that the number of loSical device assignments you will be able 
to make in the running system is equal to the number of devices 
plus empty device slots in the system you have Senerated. You 
may need to allocate extra device slots for loSical device 
assignment purposes. 

Respond with the number (decimal) of extra device slots you need. If a 
device will be supported only by an in-line service routine in a particular 
application and not by a system handler, you need not set aside a device 
slot for it. Remember also to consider the number of logical device assign- 
ments you will want to make. The range for valid responses is from to 32. 
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******#**#*#**##****#*******##*****###**♦***##****#************ 
GRAPHICS OPTIONS 

51. Do you want MTll or USSO Graphics support (N)? 

Type Y if your target configuration includes a MTll or USSO 
Graphics subsystem. RT-11 support for MSSO is minimal. The 
display handler* UTHDLR t supports UT11 but does not support any 
special features of USGO. 

52. Do you want USSO support (N)? 

Type Y if the graphics subsystem is MSSO. 

If your response is NO, SYSGEN prints the following message: 

MTll hardware assumed. 

53. What is the CSR address for the MT11/MSSO (172000)? 

The CSR addresses can be floating, The presence or absence of 
such floating address devices affects the addresses at which the 
other floating address devices in the system are installed. 
Floating address devices must be installed in a standard 
sequence. 

The standard MT11/MSS0 CSR address is 172000. However. MTH/MSBOs 
can use floating addresses. If your MTll /MSSO is installed at 
nonstandard CSR addresses, supply the correct value. The valid 
range for responses is from 1BO0OO to 177570. 

Respond with the address (octal) of the control register for the VT11 or 
VS60. The range for valid responses is from 160000 to 177570. The field 
service representative who installs your hardware system is responsible for 
supplying you with a written record of addresses at which he or she installs 
each device. 

54. What is the vector address for the MT11/MSB0 (320)? 

Many devices have floating vector addresses. The presence or 
absence of such floating address devices affects the addresses at 
which the other floating address devices in the system are 
installed. Floating address devices must be installed in a 
standard sequence. 

The standard MT11/MSB0 vector address is 320. However. MTli/MSBOs 
can use floating addresses. If your MTli/MSGO is installed at 
nonstandard vector addresses* supply the correct value. The 
range for valid responses is from 100 to 474. 

Respond with the vector address (octal) for the VT11 or VS60. The range for 
valid responses is from 100 to 474. 

TERMINAL INTERFACE OPTIONS 

Do you want an introduction to terminal interface options (N)? 

The introduction explains the DL interfaces supported by RT-11 
and how SYSGEN assigns the terminal numbers. 
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SYSGEN displays the following text if your response is YES. 

The terminal interface options allow you to select RT-11 support 
for the terminal interfaces installed in your system. RT-11 
supports a combination of serial asynchronous interfaces* which 
include the DLV11* DLM11-E. DLV11-F* DLM11-J* and the DL11 
series. It also supports DL11-E and DLU11-E interfaces* with 
modem capabilities. 

The dialog asKs first for the number of local DL11 lines* then 
the number of remote DL11 lines. The total number of lines is 
the sum of local and remote lines and must not exceed 8 lines. 
SYSGEN assigns physical unit numbers of the DL11 lines first to 
local lines and then to remote lines. This assignment is 
permanent and you cannot chanSe its order. 

After SYSGEN has established the number of lines of each type* it 
must establish the CSR and vector addresses for each line. The 
first such question corresponds to the first local line (the 
console)* the second to the second local line* etc.* until all 
local lines are accounted for. At that point* the next question 
applies to the first remote line* the second to the second remote 
line* etc.* until all remote lines are accounted for. 

If your interfaces are DL11-W interfaces* they should be at RE'. 1 E 
or higher. If they are not* an Engineering ChanSe Order (ECO DEC 
-O-LOG M785B-S0002) must be applied to the M7B5S module. The 
field service representative who installs your hardware should 
apply the ECO* if necessary. 

55. How many local DL11 lines* including the console* are to be 
supported (1)? 

Enter the total number of LOCAL DL11 terminals included in the 
tarset configuration. Since the console is always a local DLli* 
the response is never less than 1. Do not include REMOTE DL11 
lines in this number. Remote DL11 lines are specified in the next 
question. The ranSe for valid responses is from 1 to 8. 

58. How many remote DL11 lines are to be supported (0)? 

Enter the total number of REMOTE DL11 terminals included in the 
tarSet configuration. Do not include LOCAL DLli lines in this 
number. This response must not be greater than 7. 

This response must not be greater than 7, and the sum of this response and 
the response to question 55 (local DLli lines) must be less than or equal to 
8. If the total exceeds this number, SYSGEN prints the following message: 

?SYSGEN-W-Exceeded total number of valid DLli lines 

57. What is the CSR address for the first (console) DLli (177560)? 

Enter the address (octal) of the DLli interface. The ranSe for 
valid responses is from 160000 to 177570, 

The field service representative who installs your hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 
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58. What is the vector for the first (console) DL11 (GO)? 

Enter the vector address (octal) of the DL11 interface for the 
console terminal. The ranse for valid responses is from 

so to am. 

The next questions that SYSGEN asks depend on your responses to ques- 
tions 55 and 56. SYSGEN repeats questions 57 and 58, asking for the CSR 
and vector addresses for as many local interfaces as you specified in ques- 
tion 55 and for as many remote interfaces as you specified in question 56. 
Respond with the addresses for all the local interfaces before supplying the 
addresses for all the remote interfaces. Remember that the default response 
is in parentheses after the question. 

Default CSR and vector addresses for the next local DL11 interfaces are as 
follows: 

CSR Address Vector Address 

176500 300 

176510 310 

176520 320 

176530 330 

176540 340 

176550 350 

176560 360 

Default CSR and vector addresses for the next remote DL11 interfaces are 
as follows: 

CSR Address Vector Address 

175610 310 

175620 320 

175630 330 

175640 340 

175650 350 

175660 360 

175670 370 

59, Do you want DZ11 or DZVH multiplexor support (N)? 

You can select RT-11 support for one D Z 1 1 - A or DZ11-B e i S h t - 1 i n e 
multiplexor with an additional DZ11-C or DZ11-D eisht-line 
multiplexor* for a maximum of IB lines. Or you can select one 
to four DZUll four-line multiplexors. Modem support is available 
on remote lines, but is limited to Bell 103 type modems or 
equivalent. RT-11 support for modems requires the modems to 
operate in auto-answer mode. Therefore, the "common carrier and 
clear to send" options must have been installed (durinS manufac- 
ture or installation), Type Y if your configuration includes a 
DZ11 or DZU11 multiplexor. 
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BO. Do you want DZ11 multiplexor support (Y)? 
Type Y if your configuration includes a DZ11 multiplexor 

SYSGEN asks you this question only if you respond YES to question 59. If 
you respond NO, SYSGEN prints the message: 

DZV11 four-line multiplexor support is assumed. 
El. How many DZ multiplexors are to be supported (1)? 
Enter the number of DZ Multiplexors in the tarsfet configuration. 

SYSGEN asks this question only if you respond YES to question 59. 

The following dialog asks first for the number of local DZ11 or DZV11 lines, 
then the number of remote lines. The total number of lines is the sum of 
local and remote lines. SYSGEN assigns physical unit numbers of the DZ11 
or DZV11 lines first to local lines and then to remote lines. This assignment 
is permanent and cannot be changed. 

62. How many local DZ lines are to be supported altogether (1)? 

Enter the total number (decimal) of DZ lines that are local 
terminals. The ranse for valid responses is from to IB. 

63. How many remote DZ lines are to be supported altogether (0)? 

Enter the total number (decimal) of DZ lines that are remote 
terminals. The ranse for valid responses is from to IB. 

The interface vectors and CSR addresses are assigned to the floating device 
region and vary with each installation. 

64. Nhat is the CSR for the first DZ multiplexor (160010)? 

Enter the CSR address for the first DZ multiplexor. The valid 
ranse is 1B0000- 177570. 

The field service representative who installs your hardware system is re- 
sponsible for supplying you with a written record of addresses at which he 
or she installs each device. 

65. What is the vector for the first DZ multiplexor (300)? 

Enter the vector address for the first DZ multiplexor. The valid 
ranse is from BO to 474. 

If the response to question 61 was greater than 1, SYSGEN requests the 
CSR and vector addresses for the second through fourth DZ multiplexers. 
Default values for these addresses are as follows: 



1-38 Preparing for System Generation 



DZ Multiplexer CSR Address Vector Address 

2 160020 310 

3 160030 320 

4 160040 340 

GG. What baud rate do you want your lines initialised to (300)? 

The lines Must be initialised to a specific baud rate. You can 
select 9600 > 4800 > 2400 > 1200t 300. 150, or 110 baud. 

Respond with the specific baud rate at which you want your lines initial- 
ized. All DZ11 or DZV11 lines must be initialized to the same baud rate. 
The default response to this question is 300. A response other than those 
listed above produces the message: 

?SYSGEN-E-Invalid baud rate 

67. How many ports are to be supported (1)? 

Enter the number of ports you want the MSCP disk class handler 
to suppo rt . 

SYSGEN asks this question only if you request MSCP disk-class handler 
(DU) support. 



At this point, SYSGEN allows you to change any previous responses. How- 
ever, if no changes are necessary, processing continues with the creation of 
the SYSGEN.CND file. 

Do you want to chanse any of your responses ( N ) ? 

Responses have been obtained for all of the SYSGEN questions. 
You are now sf i v e n an opportunity to make minor chanSes to the 
monitor options which you have selected or to remove support for a 
device or add support for a device. If you have made a larse 
number of errors in this SYSGEN session it is recommended that you 
restart the SYSGEN dialoS. 

Press (fU) if you do not wish to change any of your previous responses. If you 
wish to change one or more dialog responses, answer YES. SYSGEN contin- 
ues by asking the following questions. 

Do you want to change monitor/terminal option responses (N)? 

You may make chanafes to most of the dialoS questions concerning 
the options to be assembled into the monitor. You may not chanse 
the monitor types to be SYBGENed. Also* you may not add or remove 
multiterminal support. To make these ohansest you must restart 
the SYSGEN d i a 1 o i . 

If no monitor-related changes are to be made, SYSGEN inquires about 
changes to device-related answers. If monitor changes are to be made, SYS- 
GEN continues with the following questions. 
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What question number do you want re-asKed? 

Respond with the number which precedes the question that you wish 
to ha ye re-asKed. 

The monitor option questions which you May change are: 

U, SJ timer support 17. User command interface 

5. Device timeout support 19. H i 9 h speed rinsf buffer 

6. System I/O error messages 20. Keyboard monitor commands 

7. System Job support 24. 50 Hz clocK 

8. .SPCPS request 25. KW11-P as system clock 

10. Asynchronous terminal status 26. Startup command file 

11. Mul t i te rminal timeout support 27. Floating point support 

12. Output buffer size 28. Memory parity support 

13. Input buffer size 29. Power failure messasfe 

14. .FETCH request under XM 30. Batch support 

15. Month and year rollover support 31. Error lossins 

50. Number of empty device slots 

51. MTH/MSBO Sraphics 

If you do not want to modify any additional monitor option 
reponses » type <RETURN>. 

Do you want to c h a n s e your device support (N)? 

Type "Y" if you want to re mo vet addi or modify support for any 
devices . 

Do you want to remove support for any device (N)? 

You are now Siven an opportunity to remove support for any device 
for which support was requested, 

If your response is YES, SYSGEN asks the following question. 

What device do you NOT want supported? 

If you previously asKed to have a device supported* but you now 
do not want support for a device* type the two letter name for 
that device. 

Do you want a list of available devices (Y)? 

After you enter the two-letter device mnemonic, SYSGEN prints the mes- 



<device> will not be supported. 

Do you want to add support for any device or have the questions for 
any device re- asked (N)? 

SYSGEN will sfive you an opportunity to add support for both 
DIGITAL supported devices and your own devices. Type "Y" if you 
want to add support for any device or change your response to a 
question relating' to a device. 

Do you want to add/modify a DIGITAL supported device (Y)? 

Type "Y" if you want to add support for any DIGITAL supported 
device or have questions related to any such device re-asked. 
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If you respond YES, SYSGEN prints the following: 

Type <ESCAPEXRETURN> for help. 

Type ?<RETURN> to list all devices. 

Type .<RETURN> when device specification is complete. 

Enter the device name to add/ modify [dd]: 

a*************************************************************** 

PHYSICAL DEVICE SELECTION AND SYSGEN CLEANUP 
##**#*#*#####•»##****#*#*•»###*#*##«•**###***##*##*****#»*■»###***#* 

When all responses have been given and no further changes are to be made, 
SYSGEN begins this phase by asking the following questions: 

What is the PHYSICAL name of the source input device [xxn] (ddn)? 

The SYSGEN assembling and linKinS process resuires a source input 
device and a binary output device* as well as an output device 
for monitor linK maps. You must specify the physical name and 
unit number for each (for example* RK1* DP4 * etc.). For more 
explanation* see the RT-11 SYSTEM GENERATION GUIDE. 

Respond with the physical device and unit number for the device on which 
you want the system sources to reside during system generation. SYSGEN 
assigns the logical device SRC: to the physical device you specify. Then, the 
SYSGEN command files use SRC: for source input. Review Section 1.2.5.1 
if you are unsure of the answer. 

What is the PHYSICAL name of the binary output device Cxxn3 (ddn)? 

The SYSGEN assembling and linkinsf process requires a source input 
device and a binary output device* as well as an output device 
for monitor linK maps. You must specify the physical name and 
unit number for each (for example* RK1* DP4 * etc.). For more 
explanation* see the RT-11 SYSTEM GENERATION GUIDE, 

Respond with the physical device and unit number for the device that you 
want to receive binary and system output. SYSGEN assigns the logical 
device BIN: to the physical device you specify. Then, the SYSGEN com- 
mand files send to BIN: the .OBJ and system files output during the system 
generation process. This device can be the same as the source input device; 
it can also be an independent output device or a system device. In any case, 
there must be sufficient space for all the files. Review Section 1.2.5.1 if you 
are unsure of the answer. 

What is the PHYSICAL name of the map output device [xxn] (ddn)? 

The SYSGEN assembling and linKinS process requires a source input 
device and a binary output device* as well as an output device 
for monitor linK maps. You must specify the physical name and 
unit number for each (for example* RK1* DP4 » etc.). For more 
explanation* see the RT-11 SYSTEM GENERATION GUIDE. 
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Respond with the physical device and unit number for the device that you 
want to list the link maps that result when you assemble and link the 
system components. SYSGEN assigns the logical device MAP: to the physi- 
cal device you specify. You can specify the console terminal or a line 
printer. Or, you can build a file for the map listings by specifying the 
physical name of a block-replaceable device such as a disk. Usually, the 
binary output device is suitable for the map files as well. Note that if you 
submit an SPR to DIGITAL for a system that you created through the 
system generation process, you must include the link maps (and the file 
SYSGEN.CND) for that system. Review Section 1.2.5.1 if you are unsure of 
the answer. 

Do you want to retain the system OBJs (Y>? 

The indirect command files that the SYSGEN proSram Generates 
delete the object modules (from which the system is built) when 
the object modules are no longer needed. This measure serves to 
conserve disk space while the system is b e i n 3 built. However* the 
object modules are often useful later when you patch the system. 
If your output device has sufficient free space* you can elect to 
retain all system object modules for future use. 



Respond YES if you have abundant mass storage (approximately 500 
blocks per monitor being built) and if you want to retain the system .OBJ 
files for later updating purposes. Note that DIGITAL distributes monitor 
updates in source form. If in doubt, respond NO. The default response to 
this question is YES. 

Do you want to retain the worK files (Y)? 

SYSGEN creates five files which are used for the system builds: 
These are the 3 indirect command files (SYSGEN. BLD* SYSGEN. MON* 
and SYSGEN. DEV) and the 2 source conditional files (SYSGEN.CND 
and SYSGEN. TBL). If you wish to have these files deleted after 
the system build procedure* SYSGEN. BLD* is run* type "N" and 
these work files will not be retained. 

To build an entire system* mount the source and binary volumes* 
copy the files SYSGEN.CND* SYSGEN. TBL* and the sources for any 
user-supplied device handlers to the source volume* and type 
$@SYSGEN.BLD. To build Just the monitors* type *@SYSGEN . MON . 
To build Just the device handlers* type *@SYSGEN . DEM . For 
more information* read the RT-11 SYSTEM GENERATION GUIDE. 

END OF SYSGEN PROGRAM - 
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Figure 1-6: System Generation Worksheet 



Monitor Type 

□ 1 . SJ monitor (Y) 

□ 2. FB monitor (Y) 

□ 3. XM monitor (N) 

Monitor Options 



□ 
□ 
D 
□ 
□ 
D 

□ 10. 

□ 11- 

□ 12. 

a 13. 
a 14. 
a 15. 

□ 17. 

□ 19. 

□ 20. 

□ 21. 

□ 22. 

□ 23. 

□ 24. 

□ 25. 

□ 26. 

□ 27. 

□ 28. 

□ 29. 

□ 30. 

□ 31. 

□ 32. 



SJ timer support (N) 
Device timeout support (N) 
Message on system I/O errors (Y) 
System job support (N) 
.SPCPS programmed request (N) 
Multiterminal support (N) 
Asynchronous terminal status (Y) 
Multiterminal timeout (Y) 

Output ring buffer size: (40) 

Input ring buffer size: (134) 

.FETCH request under XM (Y) 

Month and year date rollover (N) 

User command linkage (N) 

High-speed ring buffer (N) 

All keyboard monitor commands (Y) 

Utility subset (Y) 

Language subset (Y) 

Minimal subset (Y) 

50 Hz clock (N) 

Programmable clock as system clock (N) 

Start-up indirect command file (Y) 

Floating point (Y) 

Memory parity support (N) 

Power failure messages (N) 

BATCH support (N) 

Error logging (N) 

Number of units supported by error logging (10) 



Device Options 

□ DX RX01 Single-Density Diskette 

□ DY RX02 Double-Density Diskette 

□ DD TU58 DECtape II 

□ PD PDT-11 Intelligent Terminal 

□ RF RF11 Disk 

□ RK RK05 Cartridge Disk 

□ DL RL01/RL02 Cartridge Disk 

□ DP RP1 1 Disk Pack 

□ DM RK06/RK07 Cartridge Disk 

□ MT TM11 (UNIBUS) Magtape 

□ MM TJU1 6 (MASSBUS) Magtape 

□ MS TS1 1 (UNIBUS) Magtape 

□ CR Card Reader 

□ NL Null Handler 

□ LP Line Printer 

□ LS Serial Line Printer 

□ DU MSCP Disk-Class Handler 

□ LD Logical Disk Handler 

□ DT DECtape 

□ DS RJS03/04 Fixed-head Disk 

□ CT TA11 Cassette 

□ PC PC1 1 Paper Tape Reader/Punch 

□ PR PR1 1 Paper Tape Reader 

□ VM Virtual Memory Handler 

□ 33. Second device controllers: 



Addresses for Peripheral Device Controllers 



□ 
□ 
□ 



RX11 (N) 
RX02 (N) 
TU58 (N) 



(Questions 35 and 36) 
Controller CSR 



1stRX11 
2ndRX11 
1stRX211 
2nd RX21 1 
1stTU58 
2nd TU58 



.(177170) 
.(177174) 
.(177170) 
.(177150) 
.(176500) 
.(176510) 



Vector 

(264) 

(270) 

(264) 

(270) 

(300) 

(310) 



□ 37. No. of disk platters on RF1 1 controller: . 

□ 38. RJS03 (not RJS04) support (Y) 

□ 39. No. of RL01/RL02 units: (2) 

□ 40. RPR02 (not RPR02/RP03) support (N) 

□ 41 . File-structured magtape handlers (Y) 



.(1) 



□ 
□ 
□ 



TM11 (Y) 
TJU16 (Y) 
TS1 1 (Y) 



□ 42. No. of magtape units supported: 



□ 
□ 
□ 



Unit 

1 
2 
3 

4 
5 
6 
7 



TM11 

TJU16 

TS11 



(2) 

— (2) 
(2) 



Addresses for TS1 1 Units 

(Questions 43 and 44) 
CSR Vector 



. (172522) 
.(172526) 
.(172532) 
.(172536) 
.(172542) 
.(172546) 
.(172552) 
.(172556) 



(224) 

(300) 

(304) 

(310) 

(314) 

(320) 

(324) 

(330) 



□ 45. Printer has nonstandard CSR/vector addresses (N) 



□ 46. Nonstandard CSR address for printer: . 

□ 47. Nonstandard vector address for printer: 

□ 48. CSR address for serial line printer: 

□ 49. Vector address for serial line printer: 

□ 50. No. of extra device slots: (0) 

Graphics Options 



.(177514) 



_ (200) 
_ (176500) 
(300) 



□ 51. 

□ 52. 

□ 53. 

□ 54. 



VT11/VS60 graphics support (N) 

VS60 support (N) 

CSR address for VT1 1/VS60: 



Vector address for VT1 1 /VS60: (320) 

Terminal Interface Options 

□ 55. No. of local DL11 lines: (1) 

□ 56. No. of remote DL1 1 lines: (0) 



(172000) 



□ 34. Double-density only RX02 support (N) 



(continued on next page) 
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Figure 1-6: System Generation Worksheet (Cont.) 

CSR and Vector Addresses for Local and Remote DL11 
(Questions 57 and 58) 
Local DL11 Addresses Remote DL11 Addresses 

Lines CSR Vector CSR Vector 

1 (177560) ( 60) (console) 

2 (176500) (300) (175610) (310) 

3 (176510) (310) (175620) (320) 

4 (176520) (320) (175630) (330) 

5 (176530) (330) (175640) (340) 

6 (176540) (340) (175650) (350) 

7 (176550) (350) (175660) (360) 

8 (176560) (360) (175670) (370) 

□ 59. DZ1 1 or DZV1 1 multiplexer support (N) 

□ 60. DZ1 1 multiplexer support (Y) 

□ 61. No. of DZ multiplexers: (1) 

□ 62. No. of local DZ lines: (1) 

□ 63. No. of remote DZ lines: (0) 

Addresses for DZ Multiplexers 

(Questions 64 and 65) 
Unit CSR Vector 

1 (160010) (300) 

2 (160020) (310) 

3 (160030) (320) 

4 (160040) (330) 

□ 66. Baud rate of lines: (300) 

□ 67. No. of MSCP ports supported: (1) 

Physical Device Selection and SYSGEN Cleanup 

□ Source input device: (ddn) 

□ Binary output device: (ddn) 

□ Map output device: (ddn) 

D Retain system OBJs (Y) 

□ Retain work files (Y) 

Source Files Required 
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Chapter 2 

Performing the System Generation Process on a 
Disk System 



To perform the system generation process on a disk system, perform the 
procedures summarized in the following list and described in Sections 2.1 
through 2.4. 

1. Run the program IND.SAV. 

2. Edit the file SYSGEN.CND, if necessary. 

3. Collect the appropriate files on the appropriate media. 

4. Assemble and link the monitor(s) and device handler(s). 

The following sections correspond to each of these four procedures and de- 
scribe the steps involved in each procedure. Chapter 3 describes the proce- 
dures for performing the system generation process on diskette configura- 
tions. 

2.1 Running the Program IND.SAV 

The first procedure in the system generation process is to run the SYSGEN 
program and answer the dialog questions. 

Make sure that the files IND.SAV and SYSGEN.COM are on your system 
device and that the system device is not write-protected. The .COM files 
can reside on another volume (except magtape) as long as the volume has 
2000 free blocks and you assign the default DK: to that unit. The steps in 
this section assume that these files are on the system volume. 

Use the following command: 

.RUN IND.SAV SYSGEN. COM© 

(The dialog prints.) 
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Use the worksheet (Figure 1-6) you compiled when you read Chapter 1, 
and respond to each dialog question. The dialog asks a question, waits for 
your response, and resumes at the appropriate point. SYSGEN may skip 
some questions, depending on the responses you give. If you are not famil- 
iar with the Version 5 SYSGEN dialog, type (H§ at the end of any question 
to print an explanation. Type (EH) to terminate each response. 

Parentheses at the end of each question contain the default response. To 
select that default response, simply type (ret). You can terminate SYSGEN 
by typing (ctrl/c) . 

If you type (c trl/o ) whenever an explanation is printing, SYSGEN stops 
printing the explanation, reprints the question, and waits for your re- 
sponse. Note, however, that you should not type (ctrl/o ) while SYSGEN is 
printing a question; in this case, the end of the question is truncated, and 
you will be unable to read the question, but SYSGEN waits for a response. 

If you give an inappropriate response to a dialog question, SYSGEN prints 
an error message and repeats the question. If you receive any other error 
message while running SYSGEN, check the RT-11 System Message Man- 
ual for that message. 

If you want to change a response to a question, make a note of it, and 
continue through the dialog. After you have answered all questions, SYS- 
GEN will ask you if you wish to change any responses. Most responses can 
be changed; however, you cannot change what monitor(s) are being built, 
nor can you add or remove multiterminal support. To make these major 
changes, you must rerun SYSGEN. 

After you respond to the final system generation question, the end message 
prints on the terminal and control returns to the monitor. 

2.2 Editing SYSGEN.CND 

If you need to make any edits to SYSGEN.CND (see Section 1.2.4), do so at 
this time, but edit the file carefully. 

2.3 Collecting the Appropriate Files on the Appropriate Media 

At this point, prepare to copy files to devices according to the arrangement 
you planned in Section 1.2.5. Gather distribution backup copies that con- 
tain the source files you will need. Make sure the command files SYS- 
GEN.MON and SYSGEN.DEV (and SYSGEN.BLD, if you can use it) are on 
device DK.\ 

2.4 Assembling and Linking the Monitor(s) and Device Handlers 

SYSGEN creates command files to assemble and link the monitor(s) and 
device handlers you are generating. These command files consist of assem- 
bly and link commands (plus file deletion commands if you chose not to 
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retain the .OBJ files). You can execute the command files as they are, or 
you can alter them, as long as the final commands perform the required 
functions. For example, you might want to alter the command files as fol- 
lows: 

1. You can change the map output device to a block-replaceable device 
and create a file instead of a listing. You can suppress the link maps by 
sending the output to the null device, NL:. However, you will need to 
include a link map and answer file listing with any SPR you might 
submit to DIGITAL for a monitor created by SYSGEN. DIGITAL 
recommends saving the link maps in a file on a disk, if possible, so they 
will not be misplaced. You will also need the link maps if you wish to 
apply software customizations. 

2. You can change the devices on which individual source or binary files 
are to reside to optimize mass storage use. 

You can choose the indirect command file(s) you want to use to build the 
system. SYSGEN creates SYSGEN.MON and SYSGEN.DEV. If you want 
to build both the handlers and the monitors in the same operation and you 
have sufficient free storage, use SYSGEN.BLD, a distributed indirect com- 
mand file that invokes SYSGEN.MON and SYSGEN.DEV. On the other 
hand, if you want to build the handlers separately from the monitors, use 
SYSGEN.MON to build the monitors and SYSGEN.DEV to build the han- 
dlers. 

Edit the indirect command files at this point, if necessary. Then proceed to 
the section that describes the procedure you need to use: 

• Using SYSGEN.BLD to build the system (Section 2.4.1) 

• Using SYSGEN.MON and SYSGEN.DEV to build the system (Section 

2.4.2) 

• Building handlers separately (Section 2.4.3) 

2.4.1 Using SYSGEN.BLD to Build the System 

Generally, if you have sufficient space on the device BIN: (approximately 
2000 free blocks), you should use SYSGEN.BLD to build the system. Make 
sure that the disks to be used as SRC: and BIN: are mounted. Refer to 
Section 1.2.5 to review your plans for the system build procedure. 

Copy the appropriate source files to the device that is to serve as SRC:. In 
the following command, xxn: is your distribution backup device, unless you 
put source files on one of your working system volumes when you installed 
RT-11, and yyn: is SRC:. 

• COPY xxri : f i lnam.MAC y yy\ : f i lnaro . MA 



Performing the System Generation Process on a Disk System 2-3 



Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk, if neces- 
sary. In the following command, xxn: is the device that contains SYS- 
GEN.CND and SYSGEN.TBL, and yyn: is the device you specified as SRC: 
near the end of the SYSGEN dialog. 



.COPY xxn:5YSGEN.CND y vn : SYSGEN . CNDdJ) 
.COPY xxn:SYSGEN,TBL y yn : SYSGEN . TBLES) 



Now, consolidate the free space on the binary disk. This step is very impor- 
tant if you have space problems. In this command, zzn: is the device you 
specified as BIN: near the end of the SYSGEN dialog. 



.SQUEEZE zzn:(® 

zzn:/Siueezei Are you sure? YfEl 



Finally, invoke the indirect command file SYSGEN.BLD. Each command 
line in SYSGEN.BLD, SYSGEN.MON, annd SYSGEN.DEV logs on the ter- 
minal as the system executes the command. The following example shows 
terminal output similar to the output that will print on your terminal when 
you invoke SYSGEN.BLD. 

.iSYSGEN.BLDEH) 

$@SYSGEN.MON 

ASSIGN DL1 SRC 

ASSIGN DLO BIN 

ASSIGN DLO MAP 

ASSIGN DLO OBJ 

MACR0/0BJ:0BJ:KMFB SRC: < FB+SYSGEN . CND+EDTGBL+KMON+KMOVLY ) 

MACRO/OBJ:OBJ:RMFB SRC: ( FB+SYSGEN . CND+EDTGBL+USR+RMONFB ) 

MACRO/OBJ:OBJ:TBFB SRC: ( FB+SYSGEN . CND+EDTGBL+SYSGEN . TBL ) 

MACRO/OBJ: OBJ :BTFB SRC: ( FB+SYSGEN . CND+EDTGBL+BSTRAP ) 

MACRO/OBJ:OBJ:MEFB SRC: ( FB+SYSGEN . CND+EDTGBL+MTTEMT ) 

MACR0/0BJ:0BJ:MIFB SRC: ( FB+SYSGEN . CND+EDTGBL+MTT INT ) 

L I NK /EXE : OB J :RTi 1FB . SYG/BOU: 1000/ PROMPT/MAP: MAP :RT11FB 0BJ:BTFB 

OBJ:RMFB,KMFB,MEFB .MIFB.TBFB// 

OVLYO 

$@SYSGEN.DEM 

ASSIGN DL1 SRC 

ASSIGN DLO BIN 

ASSIGN DLO OBJ 

MACRO/OBJ:OBJ:BA SRC: ( SYSGEN . CND+BA ) 

LINK/EXE:BIN:BA.SYG OBJ:BA 

MACRO/OBJ:OBJ:DX SRC: < SYSGEN . CND+DX ) 

LINK/EXE:BIN:DX.SYG OBJ:DX 

MACRO/OBJ:OBJ:RK SRC: ( SYSGEN . CND+RK ) 

LINK/EXE:BIN:RK.SYG OBJ:RK 

MACRO/OBJ:OBJ:LP SRC: ( SYSGEN . CND + LP ) 

LINK/EXE:BIN:LP.SYG OBJ:LP 



The most common errors that can occur during the build process are listed 
in Table 2-1. 
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Table 2-1: System Build Errors 



Type of Error 



Cause* 



Assembly errors 



?MACRO-F-File not 
found DEV.FILNAM.TYP 

?MACRO-F-Device 
full DEV: 

?MACRO-F-I/0 error 
on workfile 



?MACRO-F~I/0 error 
on DEV.FILNAM.TYP 



Incorrect or conflicting responses to SYSGEN dia- 
log. 

Reexamine your responses to SYSGEN. Often, 
reading the conditional files helps you spot er- 
rors. 

If the SYSGEN responses seem correct, make 
sure that you have the proper versions of the 
source files on the source disk. Check that you 
have not introduced an error if you edited the 
source files. Compare the files on the source disk 
to the originals in the distribution. 

Failure to copy dev:filnam.typ to source disk,or fail- 
ure to include all necessary source modules on disk. 

Insufficient space on binary output device to accom- 
modate all output files. 

Insufficient space on default output device. Check 
the following possibilities: 

You did not squeeze the default device before 
starting the build. Try squeezing it and rebuild- 
ing. 

Try rerunning SYSGEN to specify not retaining 
.OBJ files and then rebuild. Try deleting other 
unnecessary files on the binary device (but be 
sure they are unnecessary). 

If all these techniques fail, you must build the 
system manually, entering the commands indi- 
vidually and building one component at a time. 
Refer to Chapter 3. 

Bad volumes or write-protected devices. 
If the volume is bad, try another. 
If the device is write-protected, enable it. 



* If you encounter an error you cannot explain or correct, refer to the RT-11 System Mes- 
sage Manual; if you still cannot resolve the problem, send an SPR to DIGITAL with a 
listing of the answer files and link maps. 

Once you have built the system, copy and store the answer files, and if 
possible, the conditional, command, and output files from the generation 
process. You should retain at least the answer files, if you use a generated 
monitor, since all SPRs must be accompanied by a listing of these files (as 
well as link maps). If you keep the object files, you can reassemble a partic- 
ular component and relink manually, if necessary. 
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The .SYG files that result from the system build are masters for your gen- 
erated system and you should preserve them. Refer to the appropriate in- 
stallation chapter in the RT-11 Installation Guide, and perform the proce- 
dures to install the generated system. Rename .SYG files, monitors and 
handlers, to .SYS. You can also rename the monitor to distinguish it from 
standard monitors. You will have to copy the bootstrap for the generated 
monitor to your system device, if you want that monitor to boot. Note that 
you can always identify a user-generated monitor by the (S) that prints in 
the boot message. 

2.4.2 Using SYSGEN.MON and SYSGEN.DEV to Build the System 

If you use SYSGEN.MON and SYSGEN.DEV to build the system, you need 
approximately 2000 free blocks on device BIN:. Make sure that the disks 
you planned to serve as SRC: and BIN: are mounted. Refer to Section 1.2.5 
to review your plans for the system build procedure. 

Copy the appropriate source files for building the monitor(s) to the device 
that is to serve as SRC:. In the following command, xxn: is your distribu- 
tion backup device, unless you included the source files in your working 
system, and yyn: is SRC:. 

• COPY xxn: f i lnam.MAC y yn : f i lnam . MAC© 



Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk. In the 
following command, xxn: is the device that contains SYSGEN.CND and 
SYSGEN.TBL, and yyn: is the device you specified as SRC: near the end of 
the SYSGEN dialog. 

• COPY xxn: SYSGEN.CND y yn : SYSGEN . CND© 

• COPY xxn:SYSGEN.TBL y yn : SYSGEN . TBL© 



Now, consolidate the free space on the binary disk. In this command, zzn: is 
the device you specified as BIN: near the end of the SYSGEN dialog. 

• SQUEEZE zzn:© 

zzn : /Squeeze ! Are you sure? y© 



Next, invoke the indirect command file SYSGEN.MON to build the moni- 
tor(s). The currently running monitor logs the commands on the terminal 
as it executes them. The following example shows terminal output similar 
to the output that will print on your terminal when you invoke SYS- 
GEN.MON. 
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,$@SYSGEN.MON(© 

ASSIGN DL1 SRC 

ASSIGN DLO BIN 

ASSIGN DLO MAP 

ASSIGN DLO OBJ 

MACRO/OBJ:OBJ:KMFB SRC: (FB + SYSGEN . CND+EDTGBL+KMON+KMOULY ) 

MACRO/OBJ:OBJ:RMFB SRC: < FB + SYSGEN . CND+EDTGBL+USR + RMONFB ) 

MACRO/OBJ:OBJ:TBFB SRC: ( FB+SYSGEN . CND+EDTGBL+SYSGEN , TBL ) 

MACRD/OBJ:DBJ:BTFB SRC: ( FB+SYSGEN . CND+EDTGBL+BSTRAP ) 

MACRO/OBJ:OBJ:MEFB SRC: ( FB+SYSGEN . CND+EDTGBL+MTTEMT ) 

MACRD/OBJ:OBJ:MIFB SRC: < FB+SYSGEN , CND+EDTGBL+MTT INT > 

L I NK /EXE : DB J :RT1 1FB . SYG/BOU : 1000/ PROMPT/MAP: MAP :RT11FB OBJ:BTFB 

OBJ:RMFB tKMFB .MEFB tMIFB tTBFB// 

OVLYO 



The most common errors that can occur during the build process are listed 
in Table 2-1. 

Now, delete all the source files that you needed to build the monitor(s) from 
SRC:. Do not delete SYSGEN.CND or SYSGEN.TBL. In the following com- 
mand, yyn: is SRC:, and aaaaaa is the file name of the source file. 

.DELETE yyn : aaaaaa. MACES) 



Then, copy to SRC: the source files that were used for building the han- 
dlers. In the following command, xxn: is your distribution backup device, 
yyn: is SRC:, and aa is the file name of the device handler source file. 

.COPY xxn:aa.MAC y yn : aa . MAC© 



•COPY xxn:zz.MAC yyn:zz.MA 



Finally, invoke the indirect command file SYSGEN.DEV to build the de- 
vice handlers. The monitor logs the commands on the terminal as it exe- 
cutes them. The following example shows terminal output similar to the 
output that will print on your terminal when you invoke SYSGEN.DEV. 

.*@SYSGEN.DEV(© 
ASSIGN DLi SRC 
ASSIGN DLO BIN 
ASSIGN DLO OBJ 

MACRO/OBJ:OBJ:BA SRC: ( SYSGEN . CND+BA ) 
LINK/EXE:BIN:BA.SYG OBJ:BA 
MACRO/OBJ:OBJ:DX SRC: ( SYSGEN . CND+DX ) 
LINK/EXE:BIN:DX.SYG OBJ:DX 
MACRO/OBJ:OBJ:RK SRC: ( SYSGEN . CND+RK ) 
LINK/EXE:BIN:RK.SYG OBJ:RK 
MACRO/OBJ:OBJ:LP SRC: ( SYSGEN . CND+LP ) 
LINK/EXE:BIN:LP,SYG OBJ:LP 
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The most common errors that can occur during the build process are listed 
in Table 2-1. 

Once you have built the system, copy and store the conditional, command, 
and output files from the generation process, if possible. You should retain 
at least the link maps and answer files, if you use a generated monitor, 
since listings of these files must accompany all SPRs. If you keep the object 
files, you can reassemble a particular component and relink manually, if 
necessary. 

Preserve the .SYG files that result from the system build; they are masters 
for your generated system. 

Refer to the appropriate installation chapter in the RT-11 Installation 
Guide, and perform the procedures to install the generated system. Rename 
.SYG files, monitors and handlers, to .SYS. You can also rename the moni- 
tor to distinguish it from standard monitors. You will have to copy the 
bootstrap for the generated monitor to your system device, if you want that 
monitor to boot. Note that you can always identify a user-generated moni- 
tor by the (S) that prints in the boot message. 

2.4.3 Building Handlers Separately 

To keep the monitor as small as possible, you may want to build a monitor 
with only a few device slots, or build many device handlers to go along with 
that monitor but use only a few devices at a time. When you select a device 
during the SYSGEN dialog, SYSGEN allocates a slot for it in the monitor 
device tables and adds commands to SYSGEN. DEV that build it. To build 
device handlers separately, you need to run SYSGEN twice. 

First, execute SYSGEN, selecting monitor options and support for the few 
devices for which you want to allocate slots. Use the resulting conditional 
and command files to build the basic system. Then, rerun SYSGEN, speci- 
fying the identical monitor options but selecting only the additional de- 
vices. Use the version of SYSGEN.DEV created during the second SYS- 
GEN session to build the additional handlers. Discard SYSGEN.MON and 
SYSGEN.BLD files from the second SYSGEN run. 

You can use one of two procedures to install additional device handlers for 
the devices you want to use during a particular session. 

1. Use the REMOVE and INSTALL commands. 

2. Use the bootstrap routine's automatic installation capability by simply 
replacing device handlers on the system device and rebooting. 

Refer to Section 2.7.11 of the RT-11 Installation Guide for a description of 
both procedures. 
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Chapter 3 

Performing the System Generation Process on a 
Small System 



If you intend to perform the system generation process on an RX01 or RX02 
system, follow the procedures in this chapter. If your system has two disk- 
ette units, you can perform the system generation process, but it is not 
recommended. It takes a long time and is not automated. If you want to 
attempt the procedures, follow all the steps in this chapter very carefully. 

Do not try to generate a system for a target configuration that is different 
from the diskette configuration on which you are performing the system 
generation process. The procedures in this chapter may not work if you try 
to generate support for many devices. 

3.1 Creating a Working System for This Process 

Begin the system generation process by creating a system diskette with the 
SJ monitor. 

Include the following files (from your working system and distribution 
backups) on the system diskette: 

RT11SJ.SYS 

xx.SYS (DX.SYS or DY.SYS) 

SWAP.SYS 

TT.SYS 

LP.SYS (if appropriate) 

IND.SAV 

SYSGEN.COM 

DIR.SAV 

PIP.SAV 

DUP.SAV 

Be sure to squeeze the diskette and copy the bootstrap to it. Then boot this 
system. 
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3.2 Running the Program SYSGEN.COM 

This procedure describes building only one monitor (and its associated de- 
vice handlers) at a time. Run SYSGEN.COM once for each monitor you 
need. Each time you run SYSGEN, answer YES to only one of the questions 
that offer the various monitors. Follow the procedure in this section to build 
that monitor and its associated handlers. Then run SYSGEN again to 
choose another monitor. Repeat the procedure in this section to build the 
monitor and handlers, and so on. 

Use the following command to run the SYSGEN program. 

.RUN IND.SAM SYSGEN.COM® 

(The dialog prints.) 

Use the worksheet (Figure 1-6) you compiled when you read Chapter 1, 
and respond to each dialog question. The dialog asks a question, waits for 
your response, and resumes at the appropriate point. SYSGEN may skip 
some questions, depending on the responses you give. If you are not famil- 
iar with the Version 5 SYSGEN dialog, type (HcH© at the end of any ques- 
tion to print an explanation. Type dm to terminate each response. 

Parentheses at the end of each question contain the default response. To 
select that default response, simply type (BE). You can terminate SYSGEN 
by typing (ctrl/c) . 



If you type (ctrl/o) whenever an explanation is printing, SYSGEN stops 
printing the explanation, reprints the question, and waits for your re- 
sponse. Note, however, that you should not type (ctrl/o ) while SYSGEN is 
printing a question; in this case, the end of the question is truncated, and 
you will be unable to read the question, but SYSGEN waits for a response. 

If you give an inappropriate response to a dialog question, SYSGEN prints 
an error message and repeats the question. If you receive any other error 
message while running SYSGEN, check the RT-11 System Message Man- 
ual for that message. 

Answer the system build questions near the end of the dialog with the 
names of devices in your configuration. Since you will read the indirect 
command files (not run them), it does not matter which device is SRC:, 
BIN:, or MAP:. 

If you want to change a response to a question, make a note of it, and 
continue through the dialog. After you have answered all questions, SYS- 
GEN will ask you if you wish to change any responses. Most responses can 
be changed; however, you cannot change what monitor(s) are being built, 
nor can you add or remove multiterminal support. To make these major 
changes, you must rerun SYSGEN. 



3-2 Performing the System Generation Process on a Small System 



After you respond to the final question, the end message prints on the 
terminal, and control returns to the monitor. 

When SYSGEN completes, the following new files appear in your system 
diskette's directory. (See Figure 1-2.) 

SYSGEN.CND 
SYSGEN.TBL 
SYSGEN.BLD 
SYSGEN.MON 

SYSGEN.DEV 
SYSGEN.ANS (optional) 

Using the following command, examine your directory to make sure that 
these files have been created. 

, DIRECTORY®) 

(The directory prints.) 

3.3 Collecting the Appropriate Files on the Diskettes 

Because you cannot fit all the files required to build your system on two 
diskettes, you must arrange the files so that you can copy them to your 
system diskette one at a time and perform the component assemblies sepa- 
rately. First, you will need to study the indirect command files to identify 
the files you will need for system build. Then, you will need to create four 
diskettes to hold the various files during the build procedure. 

3.3.1 System Build Indirect Command Files 

To ascertain the files you need, list the files SYSGEN.MON and SYS- 
GEN.DEV on the terminal or line printer. These files contain the names of 
all the source files you need to perform the assemblies to build the system. 
They also contain all the keyboard monitor commands that assemble and 
link it. 

On terminal 

, TYPE SYSGEN. MONO 
, TYPE SYSGEN. DEUdD 

On line printer 

, PRINT SYSGEN. MONdB 
, PRINT SYSGEN. DEM© 
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Figure 3-1 shows an example of SYSGEN.MON and SYSGEN.DEV (for a 
multi terminal foreground/background system). Certain lines in this exam- 
ple are numbered for reference. For example, lines 1, 2, 3, and 4 show the 
commands that assign various devices to SRC:, BIN:, MAP:, and OBJ:. 

Figure 3-1: Sample SYSGEN.MON and SYSGEN.DEV Files 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 



14 

15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



SYSGEN EDIT LEVEL = 1 

SYSGEN.MON CREATED 



19-0ct-82 16:28:35 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE. 

COPYRIGHT (o) 1982» 1983 BY DIGITAL EQUIPMENT CORPORATION. 
ALL RIGHTS RESERUED. 

ASSIGN DL1 SRC 

ASSIGN DLO BIN 

ASSIGN DLO MAP 

ASSIGN DLO OBJ 

MACR0/0BJ:0BJ:KMFB 

MACRO/OBJ: 

MACRO/OBJ: 

MACRO/OBJ: 

MACRO/OBJ: 

MACRO/OBJ: 



SRC 

SRC 

SRC 

SRC 

SRC 

SRC 
LINK/EXE:BIN:RT11FB.SYG/B0U: 1000/ PROMPT /MAP 
OBJ:RMFB »KMFB >MEFB »MIFB tTBFB// 
0VLY0 



:OBJ:RMFB 
;OBJ:TBFB 
iOBJ:BTFB 
:OBJ:MEFB 
:OBJ:MIFB 



(FB+SYSGEN.CND+EDTGBL+KMON+KMOVLY) 

(FB+SYSGEN.CND+EDTGBL+USR+RMONFB) 

(FB+SYSGEN.CND+EDTGBL+SYSGEN.TBL) 

(FB+SYSGEN.CND+EDTGBL+BSTRAP) 

(FB+SYSGEN.CND+EDTGBL+MTTEMT) 

(FB+SYSGEN.CND+EDTGBL+MTTINT) 

MAP:RT11FB OBJ; 



BTFB 



SYSGEN EDIT LEVEL = 1 

SYSGEN.DEV CREATED 



19-0ct-82 16:28:35 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED 
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE. 

COPYRIGHT (o) 1982 , 1983 BY DIGITAL EQUIPMENT CORPORATION. 
ALL RIGHTS RESERVED. 

ASSIGN DL1 SRC 
ASSIGN DLO BIN 
ASSIGN DLO OBJ 

MACRO/OBJ:OBJ:BA SRC: ( SYSGEN . CND+BA ) 
LINK/EXE:BIN:BA.SYG OBJ:BA 
MACRO/OBJ:OBJ:DX SRC: ( SYSGEN . CND+DX > 
LINK/EXE:BIN:DX.SYG OBJ:DX 
MACRO/OBJ:OBJ:DL SRC: ( SYSGEN . CND+DL ) 
LINK/EXE:BIN:DL.SYG OBJ:DL 
MACRO/OBJ:OBJ:LP SRC: ( SYSGEN . CND+LP ) 
LINK/EXE:BIN:LP.SYG OBJ:LP 



Line 5 assembles the keyboard monitor. In this command line, 
MACRO/OB J:OB J: invokes the MACRO-11 assembler and specifies the 
output device for the object file that results from this operation. OBJ: is the 
device; note that line 2 assigns DLO: to OBJ:. Therefore, if you were to 
invoke SYSGEN.MON, the object file would go to DLO:. 

KMFB is the output file name. The file type is .OBJ, since MACRO creates 
object files by default. 
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On the input side of the command string, SRC: is the input device. Line 1 
assigns DL1: to SRC:. The parentheses contain the source files to be assem- 
bled. The source input files in this command string are FB.MAC, SYS- 
GEN.CND, EDTGBL.MAC, KMON.MAC and KMOVLY.MAC. The system 
assumes .MAC files as input to MACRO. Because the files are separated by 
plus signs (rather than commas), one object file (KMFB.OBJ) results from 
this assembly. 

SYSGEN.MON contains commands similar to the ones in lines 9 and 10 
only if you are generating a multiterminal system. 

Lines 11, 12, and 13 link the monitor object modules. In the command 
string, LINK invokes the linker. The option /EXE:0BJ:RT11FB.SYG speci- 
fies a device (OBJ:) and file specification (RT11FB.SYG) for the executable 
file that results from this operation. The monitor created by this example is 
RT11FB, but it has the .SYG file type, since it is created through the 
system generation process. The option /BOU:1000 specifies the address 
boundary on which LINK should start a program section to be named when 
LINK asks for its name (line 13). /PROMPT allows additional lines to be 
entered when the command string is too long to fit on one line. If you were 
to execute SYSGEN.MON, the system would prompt with an asterisk (*) at 
line 12. Additional lines can be entered before the double slashes (//), which 
indicate the end of the command string. 

On the input side of the command, OBJ: is the input device. The default 
LINK input file type is .OBJ. BTFB is the object file BTFB.OBJ that re- 
sults from the assembly performed at line 8; RMFB is the object file 
RMFB.OBJ that results from the assembly performed at line 6; and so on. 

Line 13 is the name of the program section whose address boundary is 
specified in the /BOU:1000 option. This line responds to the system prompt 
Boundary section 1 ?, which would appear (if you were to execute SYS- 
GEN.MON) once the command string is completed. 

The command lines in the versions of SYSGEN.MON and SYSGEN.DEV 
that result from your SYSGEN session are variations of the commands in 
Figure 3-1. You can identify all the source files that you will need for your 
assemblies if you study the command files. 

When you actually assemble components, you will type each command line 
in the indirect command file. Before typing the command, however, you 
must copy to the system diskette the source files you need to perform that 
assembly. When you type the command, you must substitute specific de- 
vices (DXO: or DYO:) for SRC: and (DX1: or DY1:) for BIN:. You will not 
make the device assignments in lines 1, 2, 3, 4, 14, and 15. 

3.3.2 Creating System Build Diskettes 

Create four diskettes for the system build procedure. SYSGEN.CND and 
SYSGEN.TBL should be on your system diskette (since you have run SYS- 
GEN). The other source files are on your backup distribution diskettes. 
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When you initialize each diskette, give it an identifying volume ID. For 
example, to initialize Diskette 1, type: 



, INITIALIZE/BAD/VOL xxl:© 

xx 1 : / In i t i al i ze i Are you sure? Y(S 

?DUP-I-No bad blocks detected xxl 

Voluitie ID? DISKETTE 1© 

Owner? © 



Then, you can easily identify each diskette. For example, you can type: 



♦ DIRECTORY/ VOL® 
DISKETTE i 



3.3.2.1 Diskette Contents — The four diskettes for this procedure should 
contain the files (but only the files) in the following lists. 

Diskette 1 

The system diskette for the assembly procedure should contain: 

RT11SJ.SYS 

xx.SYS (DX.SYS or DY.SYS) 

SWAP.SYS 

TT.SYS 

LP.SYS 

MACRO.SAV 

SYSGEN.CND (from the SYSGEN session you just performed) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

SYSMAC.SML 

yy.MAC (yy is the monitor you are building: SJ, FB, or XM) 

EDTGBL.MAC 

KMON.MAC 

Diskette 2 

The second diskette will store two .MAC source files for the second assem- 
bly. It will also receive .OBJ files produced during assemblies. It should 
contain: 

USR.MAC 

RMONxx.MAC (xx is SJ or FB) 

Diskette 3 

The third diskette will store most of the .MAC source files for the assem- 
blies until they are needed on the system diskette. It must contain: 



3-6 Performing the System Generation Process on a Small System 



xx.MAC (DX.MAC or DY.MAC) 

SYSGEN.TBL (from the SYSGEN session you just performed) 

BSTRAP.MAC 

zz.MAC (zz is device name for support specified during SYSGEN) 



zz.MAC (zz is device name for support specified during SYSGEN) 
Other source files, except KMOVLY.MAC (Refer to SYSGEN.MON and 

SYSGEN.DEV.) 
LINK.SAV 

Diskette 4 

The fourth diskette should contain the KMON overlays for the KMON 
assembly. It will receive the KMON object file, and you will copy the other 
object files to it as you assemble them on Diskette 2. Diskette 4 should 
contain: 

KMOVLY.MAC 

3.3.2.2 Copying the Files — Review the installation procedures in the 
RT-11 Installation Guide, if necessary, when you create these diskettes. If 
you run out of room when you create a diskette, squeeze the diskette to 
consolidate free space. When you copy files from nonbootable diskettes, use 
the COPY/SYSTEM/WAIT command. For example, type: 

, COPY/SYSTEM/WAIT x x 1 : f i lnam . t y p x xQ : f i 1 n am . t y p(R0) 
Mount input volume in xxi:i Continue? 

Place the diskette that contains the file you want to copy in Unit 1. 



Mount output volume in xx0:5 Continue? 

Replace the system diskette in Unit with the diskette to which you want 
to copy filnam.typ. 

YdD 

Mount system volume in xxO:» Continue? 

Replace the newly created output diskette in Unit with the system disk- 
ette. 

Y(BU> 

Do not forget to copy the bootstrap to Diskette 1 and to squeeze the disk- 
ettes to consolidate free space. Do not use diskettes with bad blocks. Use 
the hardware bootstrap to boot Diskette 1, and set the date and time. 
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3.4 Assembling and Linking the Monitor(s) and Device Handlers 

Now that your files are arranged on the four diskettes, you can enter the 
command lines to assemble and link the components. First, assign the logi- 
cal name WF: to Unit 1 (RX01 or RX02). The MACRO-11 assembler uses a 
work file during some assemblies. 

.ASSIGN xxl: WF:® 



3.4.1 Assembling Files 

Insert Diskette 4 in Unit 1. Refer to your listing of SYSGEN.MON for the 
first command. Ignore the command lines that begin with ASSIGN. The 
source files required for this assembly are on Diskettes 1 and 4. 

When you type the command, you will substitute DXn: or DYn: for OBJ: 
and SRC: as shown in the following examples. You must also make other 
adjustments to this first command line because of the special size con- 
straints of the keyboard monitor assembly (always the first assembly). For 
example, you must add the /ALLOCATE: 150 option to the MACRO com- 
mand, and you must indicate that KMOVLY resides on the diskette in 
Unit 1. 

The command varies according to the type of monitor being built. For ex- 
ample, if you were building an FB monitor, the first assembly command 
line in SYSGEN.MON would be Example 1 below; you would type the 
command line displayed in Example 2. Study all these examples and your 
SYSGEN.MON listing; then execute the first assembly. Press (ret) at the end 
of each line. 

Example 1 

MACR0/0BJ:0BJ:KMFB SRC: < FB+SYSGEN . CND+EDTGBL+KMON+KMOULY ) 

Example 2 

,MACR0/0BJ:xxl : KMFB/ ALLOCATE : 150 xxO: ( FB+SYSGEN . CND+EDTGBL+KMON ) +x x 1 : KMOVLY© 

NOTE 

Refer to Table 3-1 if errors occur during assemblies. 

The first assembly may take as long as half an hour. The exact amount of 
time depends on the amount of memory — the more memory in your con- 
figuration, the faster the assembly. 

When the system completes the assembly, delete the source files KMON 
from Diskette 1 and KMOVLY from Diskette 4. Leave SYSGEN.CND and 
EDTGBL on Diskette 1; you need SYSGEN.CND for all assemblies and 
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EDTGBL for most assemblies. After you delete these files, squeeze Diskette 
1 to consolidate free space. 

•DELETE xxG:KMON.MAC(gEl> 
.DELETE xxlrKMOVLY.MAC© 
.SQUEEZE xxO:@S) 

xxO: /Squeeze 5 Are you sure? Y(H> 
RT-USJ U05.00 

(Followed by any start-up file commands.) 



Replace Diskette 4 in Unit 1 with Diskette 2. Look at the next command 
line in SYSGEN.MON. Among the source files you need for the next assem- 
bly are USR.MAC and RMONxx.MAC (where xx is SJ or FB). These two 
source files are on Diskette 2. The other source files you need for this 
assembly are on Diskette 1. Since some of the source files are on Diskette 1 
and some are on Diskette 2, you must alter the command line appropri- 
ately. For example, if the command line were Example 1 (line 6 in Figure 
3-1), you would type the command line displayed in Example 2. 

Example 1 

MACRO/OBJ: OBJ :RMFB SRC: < FB + SYSGEN . CND + EDTGBL+USR + RMONFB ) 

Example 2 

. MACRO/OBJ :xxl:RMFB xxO: ( FB+SYSGEN . CND + EDTGBL ) +xx 1 : ( USR + RMONFB )© 

» 

Delete the two source files from Diskette 2 in Unit 1. 

.DELETE xxl : (USR »RMONFB) .MAC©) 

t 

Copy the object file from this assembly from Diskette 2 to Diskette 4. 

.COPY/WAIT xxlsRMFB.OBJ xxO : RMFB , OB J© 
Mount input volume in xxl:5 Continue? Y©) 
Mount output volume in xxO:i Continue? Y© 
Mount system volume in xxQ:> Continue? Y© 

Then delete the object file from Diskette 2. 

.DELETE xxlsRMFB.OBJ© 

♦ 

Look at the next command line in SYSGEN.MON, and copy the source files 
you need for that assembly from Diskette 3 in Unit 1 to Diskette 1 in Unit 
0. For example, type: 

.COPY xxisSYSGEN.TBL x xO : SYSGEN . TBL© 
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Replace Diskette 3 in Unit 1 with Diskette 2. Enter the command line from 
SYSGEN.MON, making the required substitutions. For example, if the 
command line were Example 1 (line 7 in Figure 3-1), you would type the 
command line displayed in Example 2. 

Example 1 

MACRO/OBJ:OBJ:TBFB SRCi < FB+SYSGEN . CND + EDTGBL + SYSGEN . TBL) 

Example 2 

. MACRO/OBJ: xxl! TBFB xxO: ( FB+SYSGEN . CND+EDTGBL+SYSGEN . TBL) © 

* 

Then, delete the source file (that you previously copied) from Diskette 1. 

.DELETE xxO:SYSGEN.TBL© 
.SQUEEZE xxOs© 

Copy the object file created during this assembly from Diskette 2 to Disk- 
ette 4, and delete it from Diskette 2. 

.COPY/WAIT xxl:TBFB.OBJ xxO : TBFB , OB J© 
Mount input volume in xxl:5 Continue? Y© 
Mount output volume in xxOsi Continue? YE) 
Mount system uoluine in xxOsi Continue? Y© 
• DELETE xxl s TBFB. OBJ© 



Use the same procedure to perform all the assemblies in SYSGEN.MON 
and SYSGEN.DEV; do not perform the link operations yet. Copy source 
files from Diskette 3 to Diskette 1, and delete them from Diskette 1 after 
the assembly is complete. After you perform each assembly, be sure to copy 
the object file to Diskette 4 and delete it from Diskette 2. 

Ignore the ASSIGN commands. When you perform the link operations, the 
object files will already be on Diskette 4. The following list summarizes the 
sequence of operations for each subsequent assembly. 

1. Examine the next command line. If the command does not invoke 
MACRO, ignore the command line. If it invokes MACRO, establish 
which source files you need for the assembly. 

2. Copy these source files from Diskette 3 in Unit 1 to Diskette 1 in 
Unit 0. 

3. Replace Diskette 3 in Unit 1 with Diskette 2. 

4. Type the command, substituting xxO: for SRC: and xxl: for OBJ: (where 
xx is DX or DY). 

5. Delete the source files you copied in step 2 from Diskette 1, unless you 
need them for the next assembly. 



3-10 Performing the System Generation Process on a Small System 



6. Copy the object file from Diskette 2 to Diskette 4. 

7. Delete the object file from Diskette 2. 

8. Repeat steps 1 through 7 for each assembly command line. 

Now you are ready to perform the link operations. 

3.4.2 Linking Files 

Copy LINK from Diskette 3 to Diskette 1. 

• COPY xxlsLINK.SAV xxO:@ 



Mount Diskette 4 in Unit 1. Find the monitor LINK command in SYS- 
GEN.MON. Type the command, substituting xxl: for OBJ:. Substitute LP: 
for MAP: if you want to send the link map to the line printer. Substitute 
TT: for MAP: if you want to send the link map to the terminal. For exam- 
ple, if the command lines were Example 1 (lines 11, 12, and 13 in Figure 
3-1), you would type the command lines displayed in Example 2. 

Example 1 

LINK /EXE: BIN : RT 1 1 FB . SYG/BOU : 1000/ PROMPT /MAP : MAP : RT 1 1 FB 0BJ:BTFB 

OBJsRMFB »KMFB »MEFB >MIFB»TBFB// 

DMLYO 

Example 2 

•LINK/EXE:xxl : RT 1 1 FB . SYG/BOU i 1 000/ PROMPT /MAP : LP : RT 1 1FB xxlsBTFB® 
#BIN:RMFB »KMFB »MEFB»MIFB »TBFB//SE3 
Boundary section? OMLYO© 

NOTE 

Save the link map that results. If you ever need to submit an 
SPR to DIGITAL for your specially generated monitor, you 
must include the monitor link map with the SPR. 

Now find the next LINK command in SYSGEN.DEV. The LINK commands 
in SYSGEN.DEV link the device handlers for which you requested support 
when you ran SYSGEN. Type all the link commands, making substitutions 
for BIN:. 

The resulting linked components on Diskette 4 have the file type .SYG. The 
.SYG files are masters for your generated monitors and handlers, and you 
should preserve them. Back up the generated system and store the backup. 

Copy the .SYG files to another diskette, along with any other components 
(for example, utility programs) you need in your working system. Refer to 
the appropriate installation chapter in the RT-11 Installation Guide, if 
necessary, to install the generated system. Rename the .SYG files, moni- 
tors and handlers, to .SYS. You can also rename the monitor to distinguish 
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it from standard monitors. You will have to copy the bootstrap for the 
generated monitor to your working system device if you want that monitor 
to boot. Note that you can always identify a user-generated monitor by the 
(S) that prints in the boot message. 

Once you have built the system, store the conditional, command, and out- 
put files from the generation process. You must retain at least the link 
maps and answer files, since a listing of these files must accompany all 
SPRs, if a custom monitor is used. 

Table 3-1: System Build Errors 



Type of Error 



Cause* 



Assembly errors 



?MACRO-F-File not 
found DEV.-FILNAM.TYP 

?MACRO-F-Device 
fullDEV: 

?MACRO-F-IIO error 
on workfile 



?MACRO-F-I/0 error 
on DEV:FILNAM.TYP 



Incorrect or conflicting responses to SYSGEN dia- 
log. 

Reexamine your responses to SYSGEN. Often, 
reading the conditional files helps you spot er- 
rors. 

If the SYSGEN responses seem correct, make 
sure that you have the proper versions of the 
source files on the source disk. Check that you 
have not introduced an error if you edited the 
source files. Compare the files on the source disk 
to the originals in the distribution. 

Failure to copy dev:filnam.typ to source disk or fail- 
ure to include all necessary source modules on the 
disk. 

Insufficient space on binary output device to accom- 
modate all output files. 

Insufficient space on default output device. Check 
the following possibilities: 

You performed the system build manually but 
did not assign the work file (or the work file 
needs more space). 

You did not squeeze the default device before 
starting the build. Try squeezing it and rebuild- 
ing. 

Bad volumes or write-protected devices. 

If the volume is bad, try another. 

If the device is write-protected, enable it. 



If you encounter an error you cannot explain or correct, refer to the RT-11 System Mes- 
sage Manual; if you still cannot resolve the problem, send an SPK to DIGITAL with 
listings of the link maps and answer files. 
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Appendix A 

SYSGEN Answers That Will Duplicate the Standard 
Monitors 



Sections A.l and A.2 list the answers DIGITAL gave to create the standard 
(distributed) FB and XM monitors. Section A.3 lists all the SYSGEN ques- 
tions, without the descriptive text. 

A.1 SJ and FB Monitors 

1 . Y 



*7 
£_ t 


Y 


3. 


N 


4. 


N 


5. 


N 


6. 


Y 


7. 


N 


8, 


N 


9* 


N 


10. 


skipped 


11. 


skipped 


12. 


skipped 


13. 


40. 


14. 


134. 


15. 


N 


17. 


skipped 


19. 


N 


20. 


Y 


21. 


skipped 


22. 


skipped 


23, 


skipped 


24. 


N 


25. 


N 


2B. 


Y 


27. 


N 


28. 


N 


29. 


Y 


30. 


N 


31. 


N 


32. 


skipped 



A-l 



Enter the deuioe name you want support for [dd]: DX 

33. n 

34 • skipped 

35. 177170 

3B. 264 

Enter the next deuioe name [dd]: DY 

33. m 

34. N 

35. 177170 

36. 2B4 

Enter the next device name C d d II : DD 

33. n 

3 4 . skipped 
35. 17B500 
3B. 300 

Enter the next device name [ d d ] : pd 

Enter the next device name [ d d ] : rf 

37. i 

Enter the next device name [dd]: rk 

Enter the next device name [dd]: DL 

39. skipped 

Enter the next device name [dd]: DP 

40. Y 

Enter the next device name [dd]; DM 

Enter the next device name [dd]: MT 

41 . y 

42. 2 

Enter the next device name [dd]: MM 

4 1 . y 
42. 2 

Enter the next device name [dd]: MS 

41. y 

42. 2 

43. 172522 

44. 224 

Enter the next device name [dd]: CR 

Enter the next device name [dd]; |\||_ 

Enter the next device name [dd]: LP 

45. skipped 

46 . skipped 

47 . skipped 

Enter the next device name [dd]: LS 

48. 17B500 

49. 300 

Enter the next device name [dd]: DU 

B7. i 

Enter the next device name [dd]: LD 

Enter the next device name [dd]: DT 
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Enter the next device name C d d D : 
38. Y 

Enter the next deuice name C d d 3 

Enter the next device name Cdd] 

Enter the next deuice name Cdd] 

Enter the next device name [dd] 

Enter the next device name Cdd] 

50. N 

51. Y 

52. 172000 

53. 320 

54. 

55. skipped 

56. skipped 
5 7 . skipped 
5 B . skipped 
59. skipped 
GO. skipped 
B 1 . skipped 
B2 . skipped 
B3 . skipped 
E4. skipped 
B5 . skipped 
GB . skipped 



DS 

CT 
PC 
PR 



A.2 XM Monitor 



1 . 


N 


2. 


N 


3. 


Y 


4. 


skipped 


5. 


N 


B. 


Y 


7. 


N 


8. 


N 


3. 


N 


10. 


skipped 


11 . 


skipped 


12. 


Y 


13. 


40. 


14. 


134. 


15. 


N 


17. 


Y 


19. 


N 


20. 


Y 


21. 


skipped 


22. 


skipped 


23. 


skipped 


24. 


N 


25. 


N 


2B. 


Y 


27. 


Y 


28. 


N 


29. 


Y 


30. 


N 


31. 


N 


32. 


skipped 
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Enter the device name you want support for Cdd]; DX 

33. N 

34 . skipped 

35. 177170 

36. 264 

Enter the next device name [dd]: DY 

33. N 

34. N 

35. 177170 

36. 264 

Enter the next device name Cdd]: DD 

33. N 

34. skipped 

35. 176500 

36. 300 

Enter the next device name Cdd]: R F 

37. 1 

Enter the next device name [dd]: RK 

Enter the next device name Cdd]; DL 

3 9 i skipped 

Enter the next device name Cdd]: OP 

40. Y 

Enter the next device name Cdd]: DM 

Enter the next device name Cdd]: MT 
41 . Y 
42. 2 

Enter the next device name Cdd]: MM 

41. Y 

42. 2 

Enter the next device name Cdd]: MS 
41 . Y 

42. 2 

43. 172522 

44. 224 

Enter the next device name Cdd]: CR 
Enter the next device name Cdd]: NL 

Enter the next device name Cdd]: LP 

45. skipped 

46 . skipped 

4 7 . skipped 

Enter the next device name Cdd]: LB 

48. 176500 

49. 300 

Enter the next device name Cdd]: DL) 
67. 

Enter the next device name Cdd]: LD 

Enter the next device name Cdd]: DT 

Enter the next device name Cdd]: DS 

38. Y 
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Enter the next device name Cdd]: CT 

Enter the next device name Cdd]: PC 

Enter the next device name Cdd]: PR 

Enter the next device name Cdd]: MM 

Enter the next device name Cdd]: <(Bl 



50. 


Y 


51. 


N 


52. 


172000 


53. 


320 


54. 





55. 


skipped 


5B. 


skipped 


57. 


skipped 


58. 


skipped 


59. 


skipped 


60. 


skipped 


61 . 


skipped 


62. 


skipped 


63. 


skipped 


64. 


skipped 


65. 


skipped 


66. 


skipped 



A.3 SYSGEN Questions 



Do you want an introduction to system generation (N)? 
Do you want to use a previously created answer file (N)? 
What answer file do you want to use ( SYSGEN . ANS ) ? 
Do you want to create an answer file (N)? 
What answer file do you want to create ( SYSGEN . ANS ) ? 
Do you want to create a new SYSGEN. ANS file <N)? 
MONITOR TYPE 

1. Do you want the single-Job (SJ) monitor (Y>? 

2. Do you want the fo re S round/bacK S round <FB) monitor (Y)? 
3* Do you want the extended memory (XM) monitor (N)? 

MONITOR OPTIONS 

4 . Do you want timer support in the SJ monitor (N)? 

5. Do you want device timeout support (N)? 

6. Do you want an error messaSe on system I/O errors ( Y ) ? 

7. Do you want system Job support (N)? 

8. Do you want to use the .SPCPS request (N)? 

9. Do you want multiterminal support (N)? 

10. Do you want asynchronous terminal status (Y)? 

11. Do you want multiterminal timeout support (Y)? 
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12. Enter the size of the output buffers (40): 

13. Enter the size of the input buffers (134): 

14. Do you want to use the .FETCH request under XM (Y)? 

15. Do you want end of month and year date rollover <N)? 
17. Do you want the user command linkage (N)? 

19. Do you want hish-speed rinS buffer support (N)? 

20. Do you want all the keyboard monitor commands (Y)? 

21. Do you want the UTILITY subset <Y)? 

22. Do you want the LANGUAGE subset (Y)? 

23. Do you want the MINIMAL subset (Y)? 

24. Do you want the optional 50 Hz clock support (N)? 

25. Do you want to use the KW11-P clock as the system clock <N)? 
2B. Do you want the start-up indirect file (Y)? 

27. Do you want floatinS point support (Y)? 

28. Do you want memory parity support (N)? 

29. Do you want power failure messases (N)? 

30. Do you want BATCH support (N>? 

31. Do you want error lo93insf (N>? 

32. How many device units does error losf Job support (10)? 

DEVICE OPTIONS 
Enter the deuice name you want support for [ d d ] : 
Do you want a list of available devices (Y)? 

33. Do you want support for a second <deuice> controller (N>? 

34. Do you want RX02 double-density only support (N)? 

35. What is the CSR address for the <nth> <device> <nnnnnn>? 
3B. What is the vector address for the <nth> <device> (nnn)? 

37. How many disk platters are installed on the RF11 (1)? 

38. Do you want RJS03 rather than RJS04 support (Y)? 

39. How many RL01/RL02 units are to be supported (2)? 

40. Do you want RPR02 rather than RPR02/RP03 support (N>? 

41. Do you want the file-structured mastape handler (Y)? 

42. How many masrtape units are to be supported (2)? 

43. What is the address of the <nth> unit (nnnnnn)? 

44. What is the vector address of the <nth> unit (nnn)? 

45. Does your printer have a nonstandard vector or CSR (N)? 
48. What is the CSR address for the printer (177514)? 



A-6 SYSGEN Answers That Will Duplicate the Standard Monitors 



47. What is the vector address for the printer (200)? 

48. What is the CSR for the serial line printer U7G500)? 

49. What is the uector for the serial line printer (300)? 
Do you want to add support for any of your own devices (N)? 
Enter the device name you want support for Cdd]: 

50. How many extra device slots do you want (0)? 

GRAPHICS OPTIONS 

51. Do you want YTli or MS60 Graphics support (N)? 

52. Do you want VS6Q support (N)? 

53. What is the CSR address for the MT11/VSB0 (172000)? 

54. What is the vector address for the MTil/ySGO (320)? 

TERMINAL INTERFACE OPTIONS 
Do you want an introduction to terminal interface options (N)? 

55. How many local DL11 lines* including the console* are to be 
supported (1>? 

5G. How many remote DLli lines are to be supported (0)? 

57. What is the CSR address for the first (console) DLU (1775B0)? 

58. What is the vector for the first (console) DL11 (BO)? 

59. Do you want DZ11 or DZM11 multiplexer support (N)? 
BO. Do you want DZ11 multiplexer support (Y>? 

Bl. How many DZ multiplexers are to be supported (1)? 

B2. How many local DZ lines are to be supported altogether (1)? 

B3. How many remote DZ lines are to be supported altogether (0)? 

64. What is the CSR for the first DZ multiplexer (160010)? 

G5. What is the vector for the first DZ multiplexer (300)? 

66. What baud rate do you want your lines initialized to (300)? 

G7. How many ports are to be supported (1)? 

Do you want to chanse any of your responses (N)? 

Do you want to change Monitor/terminal option responses (N)? 

What question number do you want re-asKed? 

Do you want to chansfe your device support (N>? 

Do you want to remove support for any device <N)? 

What device do you NOT want supported? 

Do you want a list of available devices (Y)? 

Do you want to add support for any device or have the questions for 
any device re-asked (N)? 

Do you want to add/modify a DIGITAL supported device (Y)? 
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Enter the device name to add/mod i f y C d d H : 

PHYSICAL DEVICE SELECTION AND SYSGEN CLEANUP 
What is the PHYSICAL name of the source input device [xxn] (ddn)? 
What is the PHYSICAL name of the binary output device Cxxn] (ddn)? 
What is the PHYSICAL name of the map output device [xxn] (ddn>? 
Do you want to retain the system OBJs (Y)? 
Do you want to retain the worK files (Y)? 
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Appendix B 

SYSGEN Answers That Create a Multiterminal 
System 



This appendix lists SYSGEN answers that create an example of a multiter- 
minal system. Refer to Appendix A for a list of the SYSGEN questions. 

Note that this is intended to be only an example. It is highly improbable 
that the example would exactly meet your needs or that the CSR and vector 
addresses given in the example would be the same for your hardware con- 
figuration. DIGITAL does not recommend using this example, as is. 

This example creates a foreground/background multiterminal system. De- 
vice support includes RK05 disk, RX01 diskette, and eight terminals with a 
DZ11-A 8-line multiplexer. 



1 . 


N 


2, 


Y 


3. 


N 


4. 


skipped 


5. 


Y 


B, 


Y 


7, 


skipped 


8. 


N 


9. 


Y 


10. 


Y 


11 . 


Y 


12. 


Y 


13. 


40. 


14. 


134. 


15, 


N 


17. 


Y 


19. 


N 


20, 


Y 


21, 


skipped 


22, 


skipped 


23. 


skipped 


24. 


Y 


25. 


N 


26. 


Y 


27. 


N 


28. 


N 



B-l 



29. 


Y 


30. 


N 


31. 


N 


32. 


skipped 



Enter the device name you want support for CddD: DX 

33. N 

3 4 . skipped 

35. 177170 

3G. 264 

37. skipped 

3 8 • skipped 

Enter the next device name Cdd]: RK 
39. skipped 

4 . skipped 

4 1 . skipped 

42. skipped 
4 3 . skipped 

44. skipped 

Enter the next device name [dd]: LP 

45. N 

46. skipped 

47. skipped 

Enter the next device name [dd]: DU 
G7. 1 

Enter the next device name Cdd]: .(ret) 



48. 


skipped 


49. 


skipped 


50. 


skipped 


51. 


skipped 


52. 


skipped 


53. 


skipped 


54. 


5 


55. 


1 . 


56. 


0. 


57, 


177560 


58. 


60 


59. 


f 


60. 


Y 


61. 


1 . 


62. 


8 


63. 





64. 


160010 


65. 


300 


66. 


300 
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Appendix C 
RT-11 Conditionals 



The following listings contain the conditionals that the RT-11 system uses, 
with a brief explanation of each conditional. The symbols in these listings 
have the following meanings: 

Symbol Meaning 

n n n n n n CSR address 

n n n Vector address 

n Number 

x Number of local DL interfaces 

y Number of remote DL11-E lines 



C.1 System Conditionals 



AI*COD = 1 SAUTOMATIC INSTALLATION MONITOR 

BATC*H = 1 iBATCH SUPPORT 

CLOCK = 50. .POWER LINE FREQUENCY (50 CYCLE) 

CLOCK = 60, iPOWER LINE FREQUENCY (GO CYCLE) 

C0NT*N = 1 iCONTINUATION INDIRECT FILE 

CT*CSR = nnnnnn .STATUS REGISTER FOR TA11 CASSETTE 

CT*VEC = nnn iVECTOR FOR TA11 CASSETTE 

DD*PRI = n 5DECTAPE II PRIORITY 

DD*CSR = nnnnnn .STATUS REGISTER FOR FIRST DECTAPE II CONTROLLER 

DD$VEC = nnn iVECTOR FOR FIRST DECTAPE II CONTROLLER 

DD$CS2 = nnnnnn iSECOND DECTAPE II CONTROLLER STATUS REGISTER 

DD*VC2 = nnn iVECTOR FOR SECOND DECTAPE II CONTROLLER 

DDT$0 = 1 iSECOND DECTAPE II CONTROLLER IS PRESENT 

DL*UN = n 5NUMBER OF RL01/RL02 UNITS 

DL11*L = x .NUMBER OF LOCAL DL11 INTERFACES 

DLil*M = y .NUMBER OF REMOTE DL11-E LINES 

DL11*N = x + y 5T0TAL NUMBER OF DL11 LINES 

DLC*0 = nnnnnn 5CSR OF FIRST DL11 (CONSOLE) 

DLV*0 = nnn 5VECT0R OF FIRST DL11 (CONSOLE) 

DLC$1 = nnnnnn 5CSR OF SECOND DL11 (LOCAL OR REMOTE) 

DLV*1 = nnn .VECTOR OF SECOND DLli (LOCAL OR REMOTE) 

DLC*2 = nnnnnn iCSR OF THIRD DL11 (LOCAL OR REMOTE) 

DLW*2 = nnn iVECTOR OF THIRD DLU (LOCAL OR REMOTE) 



C-l 



DLC*3 

DLV*3 

DLC*4 

DLV$4 

DLC$5 

DLV*5 

DLC$B 

DLV$B 

DLC*7 

DLV*7 

DU*CS2 

DU*VC2 

DU*CS3 

DU*VC3 

DU$CS4 

DU*VC4 

DU*POR 

DX*CSR 

DX*VEC 

DX*CS2 

DX*VC2 

DXT*0 

DY*DD 

DY*CSR 

DY*VEC 

DY*CS2 

DY*VC2 

DYT*0 

DZ11*N 

DZ11$N 

DZV$11 

DZV*11 

DZCS*0 

DZVC$0 

DZCS*1 

DZVC$1 

DZCS$2 

DZMC$2 

DZCS*3 

dzvc$3 

DZ11$L 
DZ11$M 
DZSP$D 
DZSTSP 

EIS*I 
EMPTY 
EMPTY 
ERL*G 
ERL*S 
ERL*U 

FPU$11 

GRAFX 

HELP$B 
HSR*B 

JOB* 

KW11*P 

L*ANG 

LET* 

LETNO* 



n n n n ri n 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

n 

nnnnnn 

nnn 

nnnnnn 

nnn 

1 

i 

nnnnnn 

nnn 

nnnnnn 

nnn 

1 



n 



1 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

n 

n 

n 

n 

1 

n 
1 
1 
n 



CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

CSR OF 

VECTOR 

STATUS 

VECTOR 

STATUS 

VECTOR 

STATUS 

VECTOR 

NUMBER 

STATUS 

VECTOR 

STATUS 

VECTOR 

SECOND 

RX02 DO 

STATUS 

VECTOR 

STATUS 

VECTOR 

SECOND 

NO DZ11 

NUMBER 

DZ11 MU 

DZV11 M 

CSR FOR 

VECTOR 

CSR FOR 

VECTOR 

CSR FOR 

VECTOR 

CSR FOR 

VECTOR 

NUMBER 

NUMBER 

BAUD RA 

STOP UN 



FOURTH DL11 
OF FOURTH D 
FIFTH DL11 
OF FIFTH DL 
SIXTH DL11 
OF SIXTH DL 
SEVENTH DL1 
OF SEVENTH 
EIGHTH DL11 
OF EIGHTH D 
REGISTER FO 
FOR SECOND 
REGISTER FO 
FOR THIRD M 
REGISTER FO 
FOR FOURTH 
OF MSCP POR 
REGISTER FO 
FOR FIRST R 
REGISTER FO 
FOR SECOND 
RX11 CONTRO 
UBLE DENSIT 
REGISTER FO 
FOR FIRST R 
REGISTER FO 
FOR SECOND 
RX02 CONTRO 

OR DZV11 S 
OF DZii OR 
LTIPLEXER S 
ULTIPLEXER 

FIRST DZil 
FOR FIRST D 

SECOND DZ1 
FOR SECOND 

THIRD DZVi 
FOR THIRD D 

FOURTH DZV 
FOR FOURTH 
OF LOCAL LI 
OF REMOTE L 
TE 
IT 



(LOCAL OR REMOTE) 
Lll (LOCAL OR REMOTE) 
(LOCAL OR REMOTE) 
il (LOCAL OR REMOTE) 
(LOCAL OR REMOTE) 
11 (LOCAL OR REMOTE) 
KLOCAL OR REMOTE) 
DL11 (LOCAL OR REMOTE) 

(LOCAL OR REMOTE) 
Lll (LOCAL OR REMOTE) 
R SECOND MSCP 
MSCP 

R THIRD MSCP 
SCP 

R FOURTH MSCP 
MSCP 
TS 

R FIRST RX11 
Xll 

R SECOND RX11 
RX11 

LLER IS PRESENT 
Y ONLY 

R FIRST RX02 
X02 

R SECOND RX02 
RX02 

LLER IS PRESENT 
UPPORT 

DZV11 MULTIPLEXERS SUPPORTED 
UPPORT 
SUPPORT 

Zll 

1 

DZ11 

1 

ZV11 

11 

DZV11 

NES 

INES 



USE EIS INSTRUCTIONS 

NO EMPTY DEVICE SLOTS 

NUMBER OF EMPTY DEVICE SLOTS 

ERROR LOG SUPPORT 

ERROR LOG BUFFER SIZE IN BLOCKS 

NUMBER OF UNITS TO BE LOGGED 

FLOATING POINT SUPPORT 

GRAPHICS SUPPORT 

USE LARGE SINGLE LINE EDITOR HELP DISPLAY 
HIGH SPEED RING BUFFER 

NUMBER OF JOBS SUPPORTED BY SINGLE LINE EDITOR 

USE KWH*P CLOCK AS SYSTEM CLOCK 

LANGUAGE COMMANDS 

SUPPORT LET AS CCL (SINGLE LINE EDITOR) 

LET ASSIGNMENT COUNT (SINGLE LINE EDITOR) 
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LETSZ$ 
LINSZ$ 
LIGH*T 
LP.CSZ 
LP.PSZ 
LS.CSZ 
LS.PSZ 
LP*CSR 
LP*VEC 
LS*CSR 
LS$VEC 

M*INI 

MAT*S 

MM$FSM 

MM$UN 

MPT$Y 

MQH*P2 

MS*FSM 

MS*UN 

MS$CSR 

MS*VEC 

MS*CS1 

ms$vci 

MS$CS2 

MS*VC2 

MS*CS3 

MS*VC3 

MS$CS4 

MS*VC4 

MS*CS5 

MS*VC5 

MS*CS6 

MS*VCB 

MS$CS7 

MS*VC7 

MT*FSM 

MT*UN 

MTI*M 

MTT*Y 

OFORM 

PDT$OP 
PP$CSR 
PP$VEC 
PR1UX 
PWF$L 

*RFNUM 

RDF*L 

RDF*L 

RJS0*3 

RJS0*3 

RKB*B 

RKB*S 

ROL*OV 

RP0*3 

RP0*3 

RTE$M 

SILN$T 
BJONLY 
SK*CSR 
SK*VEC 
SPC$PS 



n 

n 

1 

n 

n 

n 

n 

n n n in n n 

nnn 

nnnnnn 

nnn 

1 

1 

1 

n 

1 

1 

1 

n 

nnnnnn 

nnn 

n n n n n n 

nnn 

nnnnnn 

nnn 

nnnn n n 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

nnnnnn 

nnn 

1 

n 

i 

1 

i 

1 

nnnnnn 
nnn 


1 

n 

1 

1 
1 
1 
1 


1 
1 

1 
1 

nnnnnn 
nnn 

1 



5let string length (single line editor) 

5default line size (single line editor) 
slights routine for 11/45 and 11/70 

5default value for "set lp width=nn" 

5default value for "set lp length=nn" 

5default value for "set ls width=nn" 

5default value for "set ls length=nn" 

5n0n-standard line printer cbr 

5n0n-standard line printer vector 
5csr for serial lp 

5vect0r for serial lp 

minimal commands 

asynchronous terminal status 

tju1b file-structure support 

number of tju1b units 

memory parity support 

use 2 pars for mq: and interrupt forwarding 

ts11 file-structured support 

number of ts11 units 

status register of first ts11 

vector of first tsu 

status register of second tsu 

vector of second tsu 

status register of third tsu 

vector of third tsu 

status register of fourth tsu 

vector of fourth ts11 unit 

status register of fifth tsu 

vector of fifth ts11 

status register of sixth tsu 

vector of sixth tsu 

status register of seventh tsu 

vector of seventh ts11 

status register of eighth ts11 

vector of eighth ts11 

tmu file-structure support 

number of tm11 units 

terminal time out 

multiterminal support 

5f0rm processing (len, ff , skip) lp: ls: 

5pdt support 

5pc11 pp status register 

;pc11 pp vectdr 

5pc11 or pr11 reader/punch 

5p0wer fail 

inumber of rf11 platters 
;no system i/o error message 
iadd system i/o error message 

iRJS DISK IS RJS04 

iRJS DISK IS RJS03 

iBAD BLOCK SUPPORT FOR RKOG/07 DISK 

iSPECIAL FUNCTIONS FOR RKOB/07 DISK 

5M0NTH ROLLOVER SUPPORT 

iRPll DISK IS RP02/RPR02 

iRPU DISK IS RP03 

iMONITOR RUNNING UNDER RTEM-11 

iBOOT MESSAGE NOT DISPLAYED 

5L0GICAL DISK SUPPORT FOR SJ ONLY 

5SK STATUS REGISTER 

5SK VECTOR 

iSAVE/SET MAIN-LINE PC AND PS SUPPORT 
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STAR$T 


a 


1 i 


STARTUP 


COMMAND FILE 


SYSG$N 


= 


i ; 


INDICATE SYSGENED MONITOR 


SYT$K 


3 


1 ; 


SYSTEM 


JOB SUPPORT 


TIM*IT 


s 


i ; 


ADD DEVICE TIMER SUPPORT 


TIME*R 


= 


i i 


ADD SJ 


TIMER SUPPORT 


TTYIN 


= 


n i 


SIZE OF 


INPUT RING BUFFERS 


TTYOUT 


= 


n i 


SIZE OF 


OUTPUT RING BUFFERS 


U.K. 


- 


1 i 


UK MODEM SUPPORT 


U*CL 


= 


1 i 


USER COMMAND LINKAGE SUPPORT 


U*TIL 


= 


1 


UTILITV 


COMMANDS 


VM*BAS 


= 


n 


VMX: LOWEST ADDRESS TO USE </G4.) 


VSGO* 


= 


1 


VSGO DISPLAY SUPPORT 


VT11* 


= 


1 


VT11 DISPLAY SUPPORT 


VT52* 


= 


i 


MT52 SUPPORT WITH SINGLE LINE EDITOR 


VT10O* 


= 


1 


VTiOO SUPPORT WITH SINGLE LINE EDITOR 


VT102* 


= 


1 


VT102 SUPPORT WITH SINGLE LINE EDITOR 


VT.CSR 


= 


nnnnnn 


CSR FOF 


> VT11/VSSO 


VT.VEC 


= 


nnn 


VECTOR 


FOR VTH/VSBO 


XM*FET 


= 


1 


.FETCH 


SUPPORT IN XM 


XTNCHN 


= 


n 


NUMBER 


OF DL-TYPE SERIAL LINES 


XT*PRI 


= 


n 


PRIORITY OF DL-TYPE SERIAL LINES 


XT*CSO 


= 


nnnnnn 


STATUS 


REGISTER OF FIRST DL-TYPE LINE 


xt*vco 


= 


nnn 


VECTOR 


OF FIRST DL-TYPE LINE 


XT*CS1 


= 


nnnnnn 


STATUS 


REGISTER OF SECOND DL-TYPE LINE 


XT$VC1 


= 


nrm 


VECTOR 


OF SECOND DL-TYPE LINE 


XT*CS2 


X 


nnnnnn 


.STATUS 


REGISTER OF THIRD DL-TYPE LINE 


XT*VC2 


= 


nnn 


VECTOR 


OF THIRD DL-TYPE LINE 


XT*CS3 


= 


nnnnnn 


iSTATUS 


REGISTER OF FOURTH DL-TYPE LINE 


XT$VC3 


s 


nnn 


VECTOR 


OF FOURTH DL-TYPE LINE 


XT$csa 


= 


nnnnnn 


STATUS 


REGISTER OF FIFTH DL-TYPE LINE 


XT*VC4 


= 


nnn 


iVECTOR 


OF FIFTH DL-TYPE LINE 


XT*CS5 


= 


nnnnnn 


iSTATUS 


REGISTER OF SIXTH DL-TYPE LINE 


XT*VC5 


= 


nnn 


iVECTOR 


OF SIXTH DL-TYPE LINE 


XT$CS6 


= 


nnnnnn 


iSTATUS 


REGISTER OF SEVENTH DL-TYPE LINE 


XTSVCB 


= 


nnn 


iVECTOR 


OF SEVENTH DL-TYPE LINE 


XT*CS7 


= 


nnnnnn 


iSTATUS 


REGISTER OF EIGHTH DL-TYPE LINE 


XT*VC7 


= 


nnn 


iVECTOR 


OF EIGHTH DL-TYPE LINE 



C.1.1 SJ.MAC 



BF 



iSJ MONITOR SUPPORT 



C.1.2 FB.MAC 



BF 



;no sj monitor support 



C.1.3 XM.MAC 



BF = 1 

MMG*T = 1 



;no sj monitor support 
imemory management support 



C.2 Individual Keyboard Monitor Command Conditionals 

To include or exclude individual keyboard commands, insert the particular 
conditional in SYSGEN.CND and substitute (to exclude the command) or 
1 (to include the command) for n. 
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Utility Program Subset 



U*TIL 



BACK** 


= 


n 


BOOT** 


= 


n 


COPY** 


= 


n 


CREA** 


= 


n 


DELE** 


= 


n 


DIFF** 


= 


n 


DIRE** 


= 


VI 


DUMP** 


= 


n 


EDIT** 


= 


n 


FORM** 


= 


VI 


INIT** 


= 


n 


MAKE** 


= 


n 


MUNG** 


= 


n 


PRIN** 


= 


n 


PROT** 


= 


n 


RENA** 


= 


n 


SHOW** 


= 


n 


SQUE** 


= 


n 


TECO** 


= 


n 


TYPE** 


= 


n 


UNPR** 


= 


n 



IF N IS SET EQUAL TO 0» ALL 

UTILITY COMMANDS DEFAULT = 

IF N IS SET EQUAL TO 1 , ALL 

UTILITY COMMANDS DEFAULT = 1 

BACKUP 

BOOT 

COPY 

CREATE 

DELETE 

DIFFERENCES 

DIRECTORY 

DUMP 

EDIT 

FORMAT 

INITIALIZE 

MAKE 

MUNG 

PRINT 

PROTECT 

RENAME 

SHOW 

SQUEEZE 

TECO 

TYPE 

UNPROTECT 



Language Subset 



L*ANG 



ilF N IS SET EQUAL TO 0» ALL 

SLANGUAGE COMMANDS DEFAULT = 

ilF N IS SET EQUAL TO 1 , ALL 

SLANGUAGE COMMANDS DEFAULT = 1 



BASI** 


= 


n 


5BASIC 


COMP** 


= 


n 


5COMPILE 


DIBO** 


= 


n 


iDIBOL 


EXEC** 


= 


n 


iEXECUTE 


FORT** 


= 


n 


;fortran 


LIBR** 


= 


n 


iLIBRARY 


LINK** 


= 


n 


.LINK 


MACR** 


= 


n 


5MACRO 



Minimal Subset 



M*INI 



ABOR** 


= 


n 


ASSI** 


= 


n 


B** 


= 


n 


CLOS** 


= 


n 


D** 


= 


n 


DATE** 


= 


ri 


DEAS** 


= 


n 


DISM** 


= 


n 


E** 


= 


n 


FRUN** 


= 


n 


GET** 


= 


n 



IF N IS SET EQUAL TO 0, ALL 
MINIMAL COMMANDS DEFAULT = 
IF N IS SET EQUAL TO 1 , ALL 
MINIMAL COMMANDS DEFAULT = 1 

ABORT 

ASSIGN 

BASE 

CLOSE 

DEPOSIT 

DATE 

DEASSIGN 

DISMOUNT 

EXAMINE 

FRUN 

GET 
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GT*$ 


= 


n 


;gt on/off 


HELP** 


= 


n 


5HELP 


INST** 


= 


n 


5INSTALL 


LOAD** 


= 


n 


iLOAD 


MOUN** 


= 


n 


iMOUNT 


REEN** 


= 


n 


iREENTER 


REMO** 


= 


n 


iREMOVE 


RESE** 


= 


in 


iRESET 


RESU** 


= 


n 


iRESUME 


SAME** 


= 


n 


iSAVE 


SET** 


= 


n 


iSET 


SRUN** 


= 


n 


iSRUN 


STAR** 


= 


n 


iSTART 


SUSP** 


= 


n 


iSUSPEND 


TIME** 


= 


n 


iTIME 


UNLO** 


= 


in 


iUNLOAD 
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Appendix D 

Customizations for Specially Generated Monitors 



In the following software customizations, lowercase alphabetic x represents 
a character that varies according to the specific software component you are 
modifying. 

D.1 Installing Only the Generated Handlers 

Normally, when you bootstrap an RT— 11 system, the monitor automatically 
installs any device handlers that are present on the system device, if there 
are enough device slots for them. Under certain circumstances, you may 
want the system to include only the handlers that you named during your 
system generation process. To prevent the system from recognizing han- 
dlers that you did not specify during system generation, install the follow- 
ing customization. 

NOTE 

Do not install this customization on any of the distributed 
monitors. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, and ..INS A is the value of that symbol from the monitor 
link map. 



• RUN SIPP© 






*moni t rtSYSSE) 






Base? 0© 






Offset? ..INSAdB 






Base Offset 


Old 


New 


000000 . . INSA 


010105 


zaotm 


000000 ..INSA+2 


020200 


(CTRL/Y 1IRET) 


*(CTRL/C) 







If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 



D-l 



D.2 Suppressing the Multiterminal Polling Routines 

If you selected DZ-11 modem support or the multiterminal timeout feature 
when you performed your system generation, the monitor automatically 
polls the terminal lines twice every second. This can cause ODT to malfunc- 
tion. If you make the following modification to the monitor, it will not do 
this periodic polling. This allows you to use ODT, but defeats the value of 
the multiterminal timeout feature, and prevents the monitor from recogniz- 
ing remote DZ-11 or DZV-11 lines. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, and ..DZOD is the value of that symbol from the monitor 
link map. 



.RUN SIPPEQ 




*monit r.SYSSED 




Base? 0(HD 




Offset? ..DZODEE 




Base Dffset 


Old 


000000 ..DZOD 


000000 


000000 ..DZOD+2 


001002 



New 
KB 

(CTRL/ Y) (RET) 



*E5IZsD 



If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 

D.3 Changing the Handler File-Name Suffix 

In an ordinary RT-11 SJ or FB system, the monitor recognizes device han- 
dlers by the format of their names. Device handler names have the format 
dd.SYS. In an XM system, handlers are in files named ddX.SYS. Thus, two 
sets of handlers can coexist on one system volume. 

If you generate one or more monitors with different combinations of the 
device timeout, error logging, and extended memory features, you can have 
need of up to eight different sets of device handlers. You can keep such 
handlers on one system volume by associating one or more monitors with 
the corresponding handlers. Do this by customizing the monitor so that it 
recognizes device handler file names of the form ddn.SYS, where n is any 
alphabetic character that you choose. Then rename the corresponding han- 
dler files. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, and z is the one-character suffix that you use when you 
rename the associated handlers. The old values depend on the system gen- 
eration options that you chose. 

.RUN SIPP© 
*monit r.SYSffi) 
Base? Ode) 
Offset? 4774(H) 
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Base Offset Old New 

OOOOOO 004774 000030 iR© 

000000 004774 < X> JRdM Bzt! 

OOOOOO 004776 <nnn> EtHTyK reTI 



* (ctrl7ci 



If the monitor you want to alter is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 

D.4 Changing the Default Device for the SRUN Command 

When you start a system job (by typing SRUN filnam), the default device 
on which the monitor looks for the program file is SY:. (You can run system 
jobs under an FB or XM monitor that includes the system job feature.) If 
you have a special application, you can change this default to any three- 
character device name. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..SRDK is the value of that symbol from the monitor link 
map, and nnn is the new default device name. 



.RUN SIPPED 








* m o n i t r.SYS© 








Base? 


0© 








Offset? 


, .SRDK© 






Base 




Offset 


Old 


New 


000000 




. .SRDK 


015270 


5R© 


000000 




. .SRDK 


<SY > 


5Rrmn(Ri 


000000 




. .SRDK+2 


<AW1> 


(ctruyHret) 



» (CTRL/C) 



D.5 Changing the Default File Type for the SRUN Command 

When you start a system job, the default file type for the program file is 
.REL. If you have a special application, you can change this default to any 
three-character file type. 

In this customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..SRUX is the value of that symbol from the monitor link 
map, and nnn is the new default file type. 



.RUN SIPP(E 


S3 








*Monit r.SYS© 








Base? 


0© 








Offset? 


. .SRUX© 






Base 




Offset 


Old 


New 


000000 




. .SRUX 


075273 


;r© 


000000 




. ,SRUX 


<REL> 


iRnnn® 


000000 




. .SRUX + 2 


< XXX > 


(CTRL/ Y] (RET) 



* (CTRL7cn 
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D.6 Assigning a Remote Line as the Console Terminal 

You can customize your FB and XM monitors to allow a terminal connected 
via a dial-up line to be used as the console terminal. The multiterminal 
software will answer the line when called (provided appropriate modem 
hardware is in place) and connect the remote terminal to the system as the 
console terminal. 

In this customization, monitr.SYS is the name of the multiterminal moni- 
tor file that you wish to modify, and ..CRMT is the value of that symbol 
from the monitor link map. 



.RUN SIPP® 






*moni t r.SYS® 






Base? OH 






Offset? ..CRMT® 






Base Offset 


Old 


New? 


000000 ..CRMT 


020000 


0© 


000000 ..CRMT+2 


X X X X X X 


fCTRL/Y IfRET) 


*fCTRL/C} 





D.7 Changing the Device Name of the UCL File 

If you selected user command linkage (UCL) support when you performed 
your system generation, you can customize the monitor to change the de- 
vice name from where the UCL file is run (by default SY:). Use the follow- 
ing alteration to change the contents of location ..UCLF to the RAD50 
device name. 

In the customization, monitr.SYS is the name of the monitor file that you 
wish to modify, ..UCLF is the value of that symbol from the monitor link 
map, and yyy is the name of the device from which the UCL file will be run. 

.RUN SIPP® 
*moni t r.SYS® 
Base? 0® 
Offset? ..UCLF® 

Base Offset Old New? 

000000 ..UCLF xxxxxx iRyyyO® 

000000 ..UCLF + 2 xxxxxx ggg 

* fCTRL/C ) 



D-4 Customizations for Specially Generated Monitors 



INDEX 



Addresses 

CSR, 1-5 

interrupt vector, 1-5 

nonstandard, 1-6 

vector, 1-31 
Answer files, 1-3 

editing, 1-9 

use of previously created, 1-18 
Assembly of monitor 

files required, 3-8, 3-9 

time requirements, 3-8 
Asynchronous terminal status 

system generation option, 1-6, 1-22 
Automatic installation, bootstrap, 2-8 
Automatic system build, 1-10 

BA.MAC, 1-12 

Backup, generated system, 3-11 

BATCH, 1-6, 1-29 

Baud rates, 1-39 

BIN:, 1-10 

Binary output device, 1-13, 1-42 

Block-replaceable devices 

See Devices 
BSTRAP.MAC, 1-12 

Clock 

50 Hz, 1-27 

programmable, 1-27 
Conditional files, 1-42 
Conditionals, C-l 

keyboard monitor command, C-4 

system, C-l 



Console 

assigning remote line, D-4 
Control files, 1-2 
CR.MAC, 1-12 
CSR addresses 

changing in device handlers, 1-31 

VT11/VS60, 1-35 
CT.MAC, 1-12 
Customizations 

for generated monitors, D-l 
to D-4 



Date 

rollover, 1-24 
DD.MAC, 1-12 
Device 

See also Devices 

binary output, 1-13, 1-42 

I/O timeout, 1—6 

map output, 1-13, 1-42, 2-3 

second controller, 1-30 

source input, 1-11, 1-41 

system, 1-11, 2-1 
Device handlers 

assembling and linking 
large disk, 2-2 
small disk, 3-8 

associated with specific monitors, D-2 

building, 1-42, 2-7, 2-8 

changing file name suffix, D-2 

indirect command files to build during 
system generation, 2-7 



Index-1 



installing additional, 2-8 

installing generated, D-l 

linking 
for diskette system, 3-11 

user-written, 1-34 
Device options, 1-30 

CSR addresses, 1-31 

extra device slots, 1-34 

magtape, 1-32, 1-33 

nonstandard printer, 1-33 

parallel printer, 1-33, 1-34 

RF11 subsystem, 1-31 

RJS03, RJS04, 1-31 

RL01/RL02, 1-32 

RPR02/RP03, 1-32 

RX02 double-density, 1-31 

second device controller, 1-30 

serial printer, 1-34 

user-supplied device handlers, 1-34 

vector addresses, 1-31 
Devices 

See also Device 

adding support for, 1-40 

block-replaceable, 2-3 

changing default device to SRUN 
command, D-3 

changing device name for UCL file, 
D-4 

list of valid, 1-30 

logical, 3-8 

removing support for, 1-40 
Device slots 

adding extra, 1-6, 1-34 
Device timeout support, 1-21 
Dialog, 1-17 

changing responses to, 1-9, 1-39, 2-2, 
3-2 
Dial-up line used for console terminal, 

D-4 
Diskettes 

assembling files on, 3-8 

for system build, 3-6 

initializing, 3-6 

RX01/RX02, 3-1 

system generation, 3-1 

systems, 1-17 
DL.MAC, 1-12 
DL11 interface, 1-37 
DM.MAC, 1-12 
Double-density, 1-31 

RX02, 1-6 
DP.MAC, 1-12 
DS.MAC, 1-12 
DT.MAC, 1-12 



DU.MAC, 1-12 

DU handler, 1-39 

DX.MAC, 1-12 

DY.MAC, 1-12 

DZ11/DZV11 multiplexer support, 1-38 

DZ11 line polling routine 

suppressing, D-2 
DZ11 up to 9600 baud, 1-6 
DZ lines 

baud rates, 1-39 

number of local lines, 1-38 

number of remote lines, 1-38 

Editing conditional file, 1-9 
Editing SYSGEN.CND, 2-2 
EDTGBL.MAC, 1-12 

required for assemblies, 3-8 
EL.MAC, 1-12 
ELCOPY.MAC, 1-12 
ELINIT.MAC, 1-12 
ELTASK.MAC, 1-12 
Error Logger 

generating support for, 1-30 
Error logger 

generating support for, 1-6, 1-29 
Error message on system I/O errors, 1-21 
Errors 

system build (table), 2-5, 3-12 
ERRTXT.MAC, 1-12 
Extra device slots, 1-34 

FB.MAC, 1-12 
FB monitor, 1-20 

duplicating standard, A-l 
.FETCH programmed request 

disable under XM, 1-6, 1-24 
File names 

changing, D-2 

selecting, 1-3 
Files 

answer, 1-3, 1-9, 1-18 

conditional, 1-42 
editing, 1-9 

copying 
to diskettes, 3-7 

created by SYSGEN, 3-3 

indirect 
See Indirect command files 

indirect control 
See Control files 

naming, D-2 

renaming, D-2 

source, 2-2, 2-3 

start-up indirect command, 1-27 



Index-2 



.SYG, 2-8 
SYSGEN 
See System generation 
files 
SYSGEN.MON and SYSGEN.DEV, 

3-4 
system build, 2-8 
work, 1-42 
File types 
default 
changing for SRUN command, D-3 
Floating point support, 1-8, 1-28 
Floating vector, 1-6 
Free space, consolidating, 2-4, 2-6 
FSM.MAC, 1-12 

Generating a system, 1-1 
Graphics options, 1-35 
CSR address 

for VT11/VS60, 1-35 
Vector address 

for VT11/VS60, 1-35 
VT11/VS60 support, 1-35 



High speed ring buffer, 1- 
50 Hz clock? 1-8, 1-27 



■24 



IND, 1-2 

IND.SAV, 1-2, 2-1 

Indirect command files, 1-10, 1-17, 1-42 

changing, 2-3 

editing, 2-3 

start-up, 1-27 

SYSGEN.BLD, 2-4 
Indirect Control File Processor 

See IND 
Input ring buffer, 1-23 

Keyboard commands 

conditionals for, C-4 

supporting subsets of, 1-7, 1-25 
KMON.MAC, 1-12 
KMON overlays, 3-7 
KMOVLY.MAC, 1-12, 3-7 

LD.MAC, 1-12 

Linking files in diskette system, 3-11 

Link maps 

See Load maps 
Load maps, 1-13, 3-11 

suppression, 1-14, 2-3 
Local DL11 lines, 1-36 
Logical disks, 3-8 
LP.MAC, 1-12 
LS.MAC, 1-12 



MACRO, 3-10 

work file, 3-8 
Magtapes, 1-32, 1-33 
MAP:, 1-10 
Mass storage usage, optimizing, 1-10, 

2-3 
Memory parity, 1-7, 1-28 
Monitor customizations 

See Customizations 
Monitors 

assembling and linking, 2-2, 3-8 

associating handlers with specific 
monitor, D-2 

building, 1-42 

building via indirect command file, 2-6 

customizations for, D-l 

duplicating standard, A-l 

identifier (S), user-generated, 3-12 

indirect command files to build during 
system generation, 2-6 

link maps for, 3-11 

on diskette systems, 1-17 

size considerations, 2-8 

specially generated, 2-6, 2-8, 3-12 

standard, 1-6 

type, 1-19 
Monitor services, 1-6 
Month and year rollover, 1-7 
MSCP handler 

See DU handler 
MTTEMT.MAC, 1-12 
MTTINT.MAC, 1-12 
Multiplexer 

support, 1-37, 1-38, 1-39 
Multiterminal support, 1-7, 1-22 

for U. K., 1-9 

suppressing polling routines, D-2 

system generation answers to create, 
B-l 

TRMTBL.MAC required, 1-11 
Multiterminal timeout, 1-7, 1-23 

NL.MAC, 1-12 
Nonstandard printer, 1-33 

Object files, 3-7 

on binary output device, 1-13 
Object modules 

retaining system .OBJ, 1-42 
Output ring buffer, 1-23 

Parallel printer, 1-33, 1-34 
PC.MAC, 1-12 
PD.MAC, 1-12 
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Peripheral devices, 1-5 
Physical device 

choosing support for, during system 
generation, 1-41 
Physical device names 

binary output device, 1-42 

map output device, 1-42 

source input device, 1-41 
Polling routines, suppression, D-2 
Power failure message, 1-29 
Printer 

nonstandard addresses, 1-33 

parallel, 1-33, 1-34 

serial, 1-34 
Programmable clock, 1-7, 1-27 

Remote DL11 lines, 1-36 
Remote line, assigning as console 

terminal, D-4 
RF.MAC, 1-12 
RF11 subsystem, 1-31 
Ring buffers, 1-7 

high-speed, 1-6 
RJS03, RJS04, 1-31 
RK.MAC, 1-12 
RL01/RL02, 1-32 
RMONFB.MAC, 1-12 
RMONSJ.MAC, 1-12 
RMONxx.MAC, 3-9 
RPR02/RP03, 1-32 
RX01 diskette, 3-1 
RX02 diskette, 3-1 

double-density only, 1-6, 1-31 

Save/set main-line PC & PS, 1-22 
Serial printer, 1-34 
Single-job monitor 

See SJ monitor 
SJ.MAC, 1-12 
SJ monitor, 1-19 

duplicating standard, A-l 
SJ timer support, 1-20 
Software Performance Report 

See SPR 
Source files, 2-2 

changing device, 2-3 

deleting, 2-7 

on second disk for system build (figure), 
1-15 
Source input device, 1-11, 1-41 
.SPCPS programmed request, 1-8 
SPR, 1-14, 2-8, 3-12 

for specially generated monitor, 3-11 



SRC:, 1-10 

SRUN keyboard command 

changing default device, D-3 

changing default file type, D-3 

default file type 
changing, D-3 
Start-up indirect command files, 1-27 
.SYG files 

master files for generated monitors and 
handlers, 3-11 

renaming, 2-6 
SYSGEN 

See System generation 
SYSGEN.ANS, 3-3 

SYSGEN.BLD, 1-42, 2-2, 2-3, 2-4, 3-3 
SYSGEN.CND, 1-9, 1-11, 1-12, 2-1, 2-2, 
2-4, 3-3 

required for assemblies, 3-8 
SYSGEN.COM, 1-2, 2-1, 3-2 
SYSGEN.DEV, 2-2, 2-3, 2-6, 2-7, 3-3 
SYSGEN.MON, 2-2, 2-3, 2-6, 3-3 
SYSGEN.MON and SYSGEN.DEV files 

(figure), 3-4 
SYSGEN.TBL, 1-11, 1-12, 2-4, 3-3 
System 

indirect command files to build during 
system generation, 2-3 
System build 

all files on one disk (figure), 1-14 

automatic, 1-10 

creating diskette system, 3-5 

default device requirements, 1-11 

diskettes, 3-6 

errors (table), 2-5, 3-12 

files to retain, 2-8 

indirect command files, 1-17, 2-3, 3-3 

manual, 1-17 

procedure, 1-10 
for diskette system, 3-3 

required free blocks, 1-11 

second disk and line printer receive 
output (figure), 1-16 

source files on second disk (figure), 
1-15 

using SYSGEN.BLD to perform, 2-3 

using SYSGEN.MON and 
SYSGEN.DEV, 2-6 
System device, 1-11, 2-1 

diskette system, 3-5 
System generation 

default answers, 1-17, 2-2 

dialog, 1-17, 2-2 
changing responses to, 1-39, 2-2, 3-2 
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monitor options, 1-20 

monitor questions, 1-19 
features available (table), 1-6 
files, 2-2 

altering command, 2-3 

command, 2-3 

output, 1-3 
gathering information for, 1-5 
I/O error message support, 1-7 
input/output (figure), 1-4 
on large system, 2-1 
on RX01/RX02 diskette system, 

1-17 
on small system, 3-1 
preparation, 1-1 
procedure on disk system, 2-1 
process, 1-2 
process (figure), 1-4 
questions 

summary of, A-5 
retaining system.OBJ files, 1-42 
source files, 1-11 
terminating, 2-2, 3-2 
worksheet (figure), 1-43 
System generation options 
asynchronous terminal status, 1-22 
BATCH, 1-29 
date rollover, 1-24 
device timeout support, 1-21 
dialog, 1-20 

error logging, 1-29, 1-30 
error message on system I/O errors, 

1-21 
.FETCH request, 1-24 
floating point, 1-28 
high-speed ring buffer, 1-24 
50 Hz clock, 1-27 
input ring buffer, 1-23 
keyboard monitor commands, 1-25 

language subset, 1-26 

minimal subset, 1-26 

utility subset, 1-25 
memory parity, 1-28 
multiterminal support, 1-22 
multiterminal timeout support, 1-23 
output ring buffer, 1-23 
power failure message, 1-29 
programmable clock, 1-27 
save/set main-line PC & PS, 1-22 
SJ timer support, 1-20 
.SPCPS request, 1-22 
start-up indirect command file, 1-27 



system job support, 1-21 
user command linkage, 1-24 
System job support, 1-8, 1-21 

Terminal 

asynchronous, 1-6 
Terminal interface options 
baud rates, 1-39 
DL11 
lines, 1-36 
local lines, 1-36 
remote lines, 1-36 
DZ 
lines, 1-38 
multiplexer, 1-38 
remote lines, 1-38 
DZ11 

multiplexer support, 1-38 
DZ11/DZV11 multiplexer support, 1-37 
introduction, 1-35 
vector addresses 
first DZ multiplexer, 1-38 
Timer support, 1-7 
TJ.MAC, 1-12 
TM.MAC, 1-12 
TRMTBL.MAC, 1-11, 1-12 
TS.MAC, 1-12 
TT.MAC, 1-12 

UCL, 1-8 

changing default device, D-4 
User command linkage 

See UCL 
USR.MAC, 1-12, 3-9 

Vector, floating, 1-6 
Vector addresses, 1-31 

first DZ multiplexer, 1-38 

VT11/VS60, 1-35 
VM.MAC, 1-12 
Volume ID, 3-6 
VT11/VS60 

support, 1-35 

Work files 
MACRO, 3-8 
retaining, 1—42 

XM.MAC, 1-12 
XM monitor, 1-20 

duplicating standard, A-3 
XMSUBS.MAC, 1-12 
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HOW TO ORDER 
ADDITIONAL DOCUMENTATION 



From 



Call 



Write 



Chicago 



312-640-5612 
8:15 a.m. to 5:00 p.m. CT 



Digital Equipment Corporation 
Accessories & Supplies Center 
1050 East Remington Road 
Schaumburg, IL 60195 



San Francisco 
Alaska, Hawaii 



408-734-4915 
8:15 a.m. to 5:00 p.m. PT 

603-884-6660 
8:30 am. to 6:00 p.m. ET 

or 408-734-4915 

8:15 a.m. to 5:00 p.m. PT 



Digital Equipment Corporation 
Accessories & Supplies Center 
632 Caribbean Drive 
Sunnyvale, CA 94086 



New Hampshire 

Rest of U.S.A., 
Puerto Rico* 



603-884-6660 
8:30 A.M. to 6:00 p.m. ET 

1-800-258-1710 
8:30 a.m. to 6:00 p.m. ET 



Digital Equipment Corporation 
Accessories & Supplies Center 
P.O. Box CS2008 
Nashua, NH 03061 



'Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575) 



Canada 
British Columbia 

Ottawa-Hull 

Elsewhere 



1-800-267-6146 
8:00 am. to 5:00 p.m. ET 

613-234-7726 
8:00 am. to 5:00 p.m. ET 

112-800-267-6146 

8:00 am. to 5:00 p.m. ET 



Digital Equipment of Canada Ltd 
940 Belfast Road 
Ottawa, Ontario K1G 4C2 
Attn: A&SG Business Manager 



Elsewhere 



Digital Equipment Corporation 
A&SG Business Manager* 



*c/o DIGITAL'S local subsidiary or approved distributor 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

— Assembly language programmer 

— Higher-level language programmer 

— Occasional programmer (experienced) 

— User with little programming experience 

— Student programmer 

— Other (please specify) 



Name Date . 



Organization — Telephone . 

Street , 



City . State Zip Code . 



or Country 
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